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altimeter operation and details of the various data anomalies that have been resolved. 
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7121 Standard Drive 
Hanover, MD 21076-1320 
Price Code: A17 


National Technical Information Service 
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Foreword 


This document is a compendium of the WFF TOPEX Software Development Team's 
knowledge regarding Geophysical Data Record (GDR) Processing. It includes many 
elements of a Requirements Document, a Software Specification Document, a Soft- 
ware Design Document, and a User’s Manual. In the more technical sections, this 
document assumes the reader is familiar with TOPEX and GDR files. 
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Section 1 

Introduction 


1.1 Purpose 

This document provides a detailed description of TOPEX Geophysical Data Record 
(GDR) Processing at NASA Goddard Space Flight Center s Wallops Flight Facility 
(WFF). GDR Processing is work-in-progress and this document will be updated to 
reflect changes in the documented software or procedures. 

1.2 Scope 

This document is Volume 5 in a series of publications generated by the TOPEX Soft- 
ware Development Team (SWDT) at WFF. Volume 1 is an overview of the project and 
its processes. Volume 2 documents pre-launch Radar Altimeter System Evaluator 
(RASE) processing. Volume 3 documents the Altimeter Instrument File (AIF) process- 
ing. Volume 4 documents Sensor Data Record (SDR) processing and Volume 6 covers 
Special Processing which does not fall into any of the other categories. The series is 
an attempt to document SWDT software and procedures used in support of TOPEX 
at WFF. 

1.3 Organization of Document 

Section 2 lists other documents related to this document. Section 3 describes Geo- 
physical Data Record files. Sections 4, 5 and 6 document Daily, Per-Cycle, and Special 
Processing, respectively. Section 7 details the components of GDR processing. 
Appendix A contains samples of GDR Standard Products. Appendix B lists programs 
and software used and developed. Appendix C describes the contents of GDR output 
files and databases. Appendix D contains the change history for the GDR Process- 
ing. Appendix E contains significant documents and memos related to GDR Process- 
ing. 
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Section 3 

Geophysical Data Record Files 


3.1 Definition 

Geophysical Data Record (GDR) files are created from Sensor Data Record (SDR) files 
by the TOPEX Ground System (TGS) at the Jet Propulsion Laboratory (JPL). GDR 
files provide WFF with the same products as used by TOPEX scientists and research- 
ers. 

The flow of altimeter data is depicted in Figure 3-1 "TOPEX ALT Dataflow (GDR 
Emphasized)," where emphasis is placed on the GDR data flow. The TOPEX Ground 
System extracts altimeter science and engineering minor frames from the spacecraft 
telemetry. Common frames are then merged and time-sorted to create Altimeter 
Instrument Files (AIFs). AIFs and the earth-location data are processed using Teleme- 
try and Science-level algorithms to create once-per-pass (about 56 minutes) SDR files. 
The SDR files are further processed using Geophysical-level algorithms to create 
Interim Geophysical Data Records (1/ GDR). The processed IGDRs are placed in tem- 
porary storage. Once precision orbit data has been received by JPL, the new orbit 
data is merged into the IGDRs and final GDRs are created. At the end of a 10-day 
Cycle, the GDR pass files are copied to tape. 

For a complete description of the GDR formats, see TOPEX Ground System Software 
Interface Specification. Vol. 2: Design (SIS-2). Geophysical Data Record (GDR) - GDR 
Data. Interim Geophysical Data Record (IGDR) - GDR Data . 

3.2 Distribution 

Individual IGDR pass files are made accessible to WFF via the NASA Science Internet 
(NSI) using FTP protocols. GDR per-cycle exabyte tapes are mailed to GDR data sub- 
scribers. The WFF SWDT receives these tapes and archives them for later use. The 
SWDT redistributes copies of the GDR tapes to external users if so requested. 

3.3 Storage 

A single GDR pass file requires approximately 500 kilobytes of disk storage. A full 
cycle of GDR pass files consumes approximately 125 megabytes of disk space. WFF 
generally keeps the latest cycle of GDRs in the working area. Every GDR cycle 
exabyte tape generated has been archived and is available for use at WFF. 
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Section 4 

l/GDR Daily Processing 


4.1 l/GDR Daily Processing 

Each day, new IGDRs are automatically retrieved from JPL and processed by WFE 
Nightly, a VMS script on TGSC, one of the TOPEX VAX systems at JPL, creates a file 
which contains the names of the GDR files that were created since the last time the 
script was run. The WFF daily processing script, autogdr, is executed each day at 
0800 UTC by the UNIX crontab facility, autogdr retrieves the file of new filenames 
and transfers each file to WFF, where it is processed and standard products are 
printed. See Figure 4-1 'TOPEX GDR Daily Processing" on page 4-2. The timing is set 
up such that when WFF personnel arrive to work, all daily processing is complete 
and the standard products are available for inspection, autogdr performs the follow- 
ing functions (in order). 

• Runs ftpjplbin, which uses FTP to transfer IGDR files from JPL via the NASA 
Science Internet (NSI). If the transfer is not successful, the program will retry 
the copy 300 times with a 180 second timeout between copies. A log is kept of 
the processing; upon completion, this log is electronically mailed to the user 
who invoked the process. 

• Runs dogdr, the primary GDR data reduction program. It creates 10-second 
science averages and 60-second science database and header database import 
files. A log file of the processing is maintained. 

• Searches the log file for error message "Bad_InitiaI_Sigma," and transfers the 
message to a cumulative log file "BadInitSigma.Log." 

• Concatenates the dogdr database files into the corresponding merged IGDR 
database files in / gen/ topex/ data/ dbase, the database storage area. 

• Moves the IGDR files into / gen /topex/ data / igdr, the IGDR storage area. 

• Runs igdrpass, a UNIX script that runs the IDL program igdrpass.pro to 
read dogdr science averages file and create IGDR pass plots, a sample of 
which is shown in Appendix A, Figure A-l. 
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Section 5 

Per-Cycle Processing 


5.1 Per-Cycle Processing 

At the end of each 10-day TOPEX cycle, JPL creates tapes of GDRs and distributes 
these tapes to the GDR data subscribers. When a GDR tape is received by WFF, it is 
processed and the GDR data replaces the IGDR data in the database. The summary 
database is updated to reflect the new GDR entries, and the following process is per- 
formed to produce per-cycle and launch-to-date trend GDR plots. [The data flow is 
depicted in "" on page 5-2.] 

• igdrdb, a UNIX script that runs the IDL program igdrdb.pro to read the GDR 
Science database extraction file is executed. It creates GDR Cycle Summary 
Plots, a sample of which is shown in Appendix A, Figure A-2. 

• igdrsum, a UNIX script that runs the IDL program igdrsum.pro to read the 
GDR Summaiy database extraction file is executed. It creates GDR trend plots, 
a sample of which is shown in Appendix A, Figure A-3. 
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Section 6 

GDR Special Processing 


Special processing is defined as that processing which is not done on a regular chro- 
nological basis. Many dogdr products can be used for special processing along with 
commercial-off-the-shelf (COTS) software. Special processing can also be performed 
using IDL and Database Software. There are many other forms of special processing 
performed on TOPEX data; this section explains the general methods by which spe- 
cial processing is performed. 

6.1 dogdr Special Processing 

In general, GDR Special Processing is performed by using dogdr to create one or 
more special output files. The resulting files are then copied to a user for analysis or 
one of the TOPEX SWDT members uses custom IDL or COTS software to create the 
desired product. Any dogdr option can be used for special processing, but one of the 
more common ones is Science Averages, a sample of which is shown in Appendix A, 
Figure A-4. 

6.2 IDL Special Processing 

Another way to perform special processing is to create special IDL plot programs. 
This has been done on occasion to create special plots for papers and/ or presenta- 
tions. Many of the standard IDL programs can also be run using non-standard argu- 
ments to plot according to custom specifications. 

6.3 Database Special Processing 

Custom database programs have been written to perform special processing. 
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Section 7 

Components of GDR Processing 

Figure 7-1 "1/ GDR Processing Dataflow" depicts the four major components of 1/ 
GDR processing software: FORTRAN data processing software (dogdr), UND( 
scripts (User Input), FoxBase (I /GDR databases), and IDL plotting routines. 



I 
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These components comprise a system that is sufficiently automated to handle stan- 
dard processing tasks and yet flexible enough to assist in highly-detailed engineering 
assessment investigations. 

7.1 dogdr 

dogdr is the FORTRAN program responsible for all GDR data processing. It is highly 
interactive, allowing the user to choose which process to run and to specify custom- 
ized parameters for the chosen process. Figure 7-2 "dogdr Startup Screen" depicts the 
dogdr startup screen. 

dogdr has three main components: Initialization Module, User Input Module, and 
the Data Processing Loop. Figure 7-3 diagrams the highest-level dogdr processing. 
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Figure 7-2 dogdr Startup Screen 


The software currently runs on osb3, a Sun Microsystems Ultra 170 UNIX worksta- 
tion. However, since dogdr was originally coded on the Apple Macintosh platform, 
and then ported to the Sun environment, the code has been designed to be highly 
portable. 

7.1.1 dogdr Initialization Module 

Upon startup, dogdr initializes two byte maps needed to decode and process data. 
These byte maps are used for easily referencing which bytes in the raw GDR data cor- 
respond to which converted engineering units. Table 7-1 "Data Structures Initialized 
by dogdr" lists the two data structures initialized by dogdr. 
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Figure 7-3 dogdr Main Processing 
Table 7-1 Data Structures Initialized by dogdr 


Structure 

Description 

IGDRHdrDef 

Byte map of data contained in the l/GDR header record. 

IGDRDef 

Byte map of data contained in the l/GDR data record. 


7.1.2 dogdr User Input 

dogdr is designed to be highly interactive and offers the user a variety of processing 
options. The user must enter the Cycle and Pass of the file to process and select a pro- 
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(x) Exit 
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Figure 7-4 dogdr Primary User Input Screen 


cessing method. The processing selection screen is shown in Figure 7-4 "dogdr Pri- 
mary User Input Screen". The user may optionally set custom parameters such as 
averaging time, mode selection, and parameters to report. Defaults are provided in 
all cases. Table 7-2 "dogdr Processing Options" lists processing type, options, and 
defaults. Time selection is available as an option for all processes. 
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Table 7-2 dogdr Processing Options 


Process 

Options 

Defaults 

STANDARD Processing 
(default process) 

none 

Create GDR Databases 
10 sec Science Averages 

Create GDR Databases 

none 

1 Minute GDR Averages 
Headers 

Dump GDR for Print 

Time Selection 

Process All Data 

Dump GDR for StatView 

Time Selection 

Process All Data 

Create GDR Averages 

Seconds to Average 
Modes to Process 
Time Selection 

1 second Averages 
All Modes 
Process All Data 


7.1.3 dogdr Processing Loop 

After a user has chosen what process(es) to run and what options to use, dogdr runs 
in a processing loop until either all data has been read from the GDR file or a time is 
detected that is later than a user-specified stop time, dogdr branches off the main 
loop to run those processes that the user has specified. 

7.1.4 dogdr Science Unit Conversion 

GDR Science data must be converted from GDR data into appropriate science units in 
order to be used during processing. The process that performs this conversion is 
GDRSciConv.f. All parameters in the GDR Science data record are converted into 
meaningful science units for processing. 

7.1.5 dogdr Standard Processing 

Standard Processing is the default process for dogdr. Standard Processing calls two 
processing modules with specific parameters: the process of creating science aver- 
ages (GDRAvg.f) and the creation of science database (GDRDBAvg.f). Table 7-3 
"Standard Processing Modules and Parameters" lists the modules called and the cor- 
responding parameters supplied. See Appendix C for a list of output file formats for 
processing. 


Table 7-3 Standard Processing Modules and Parameters 


Module 

Parameters 

Average Science 

10 Second Averages 

D6 Science 

60 Second Averages 

DB Header 

1 Per Cycle 
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7.1.6 dogdr Create GDR Databases 

Create GDR Database calls the process module (GDRDBAvg.f). Figure 7-5 "GDRD- 
BAvg Process" illustrates the processing overview. Table 7-4 "Standard Processing 
Modules and Parameters"lists the modules called and corresponding parameters 
supplied. See Appendix C, Table C-l (Header) and Table C-4 (Science) for a list of 
output file contents and formats. 

7.1.7 dogdr Dump GDR 

The telemetry dumping routine dumps all decoded parameters in each science 
record to output files. The user may specify if all data is dumped or just the first entry 
of each parameter array. The process that performs the dump for printing is 
(DumpIGDRPmtf) and for plotting is (DumpIGDRStat.f).See Appendix C, Table 
C-3, for output file contents and formats. 

7.1 .8 dogdr Average GDR Data 

The averaging process averages (GDRAvg.f) specific decoded parameters and 
selected averaging time. See Appendix C, Table C-2,for a list of output file contents 
and formats. 

7.2 GDR Database Management 

The ORACLE Relational Database Management System (RDBMS) is being used to 
manage the TOPEX I/GDR data. Using this system, I/GDR data can be loaded, 
extracted, searched, and sorted. Data is stored in database objects called tables. 

7.2.1 Database Table Definitions 

There are three database tables used in storing the I/GDR data. 

GDR_HEADER table contains header information for each pass of a cycle. 
GDR_SCIENCE table contains 60-second averaged scientific data records. 
GDR_SUMMARY table contains a summarized scientific data record for each cycle. 
Table 7-5 "GDR Database Import Files" lists the files required to import data. 

7.2.2 Loading Data into the Database Tables 

The I/GDR database tables are loaded using the Oracle utilities, sqlldr, sqlplus, and 
PL/SQL. The sqlldr utility loads data into the database tables using a control file, 
which maps the format of the input datafile to the database table. The sqlplus utility 
and PL/SQL procedures are used to perform miscellaneous checks and updates to 
database tables after loading. 

7.2.3 Extracting Data from the Database Tables 

The Oracle utilities, sqlplus and PL/SQL are also used for extracting data from the 
database tables. These utilities are used to filter data and create output files to be used 
in further processing. 
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NOT 
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Water 



NumRecsDel++ 


NumTFIags++ 

NumRecsDel++ 


Increment Counters Where 
Respective Flags are Non-Zero 
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Figure 7-5 GDRDBAvg Process 
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Table 7-4 Standard Processing Modules and Parameters 


Module 

Parameters 

DB Science 

60 Second Averages 

DB Header 

1 Per Cycle 


Table 7-5 GDR Database Import Files 


Std. Filename 

Database 

Description 

igdr###.hdr 

header 

Concatenated files of dogdr headers output. 

igdr###.sci 

sci 

Concatenated files of dogdr 1 -minute science output. 

Note: ### denotes Cycle Number 


7.3 GDR IDL Software 

IDL, Interactive Data Language, is a software package written by Research Systems, 
Inc. It is an array-based scientific visualization package that enables a programmer to 
quickly and easily write code to generate highly customized plots and analyses. IDL 
has allowed the TOPEX SWDT to automatically generate products that were difficult 
and time-consuming to produce using COTS software. 

TOPEX IDL programs generally can read dogdr Average files or database export files 
and produce standardized plots on a PostScript printer. These programs are coded 
with a set of parameters which may be modified to customize features of the final 
output without changing the IDL code. Table 7-6 "IDL Parameters" lists the standard 
parameters that may be modified by the user. Appendix B lists the UNIX scripts 
which run TOPEX IDL programs. 

7.4 UNIX Scripts 

UNIX scripts are used to automate common tasks and supply standard parameters to 
TOPEX GDR software. Shell scripts are invoked by the crontab facility to perform 
daily processing. Other shell scripts are used for automatically retrieving and pro- 
cessing special data from JPL, for automatically running IDL programs, and for mis- 
cellaneous utility functions. Appendix B contains a list of UNIX scripts which are 
available for use. 
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Table 7-6 IDL Parameters 


Parameter 

Default 

Description 

InputFile 

n/a 

Test file from which data to be processed is read. 

XPIots 

varies 

Number of plots stacked horizontally per page. 

YPIots 

varies 

Number of plots stacked vertically per page. 

Printer 

topex2 

Printer where output will be printed. 

AutoScale 

FALSE 

Switch to automatically set axis scales by min & 
max of data, rather than by standard scale values. 

Landscape 

varies 

Switch to print in landscape rather than portrait 
mode. 

DeviceType 

‘ps’ 

Type of device driver to use.(ps = PostScript) 

PlotTitle 

InputFile 

Title of place on plot. May be overridden by pro- 
gram. 

Color 

TRUE 

Switch to define that color should be used for out- 
put. 

Scale 

1.0 

Factor by which to scale whole page. Useful for 
incorporating output in presentations or publica- 
tions. 

Manual 

FALSE 

Switch to define that printer should be set to Manual 
Feed mode. Highly printer-dependent. 

All 

FALSE 

Switch to define that all output products should be 
printed rather than the standard subset. Used by 
only some programs. 
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l/GDR Cycle Summary : Cycle 1 40 

1 -Minute Averages from IGDR Database 

Processing Summary Flagging Summary 


Level 0 : All Data 

Records Processed : 468482 

Level 1 : Deep Water, TFlag=0 
Records Processed : 457401 

Records Deleted : 1 1 081 ( 2.632%) 

Level 2 : Level 1, AltBadx=0 

Records Processed : 420994 

Records Deleted : 36407 { 8.648%) 

Good Data = Remainder After Removing Level-2 Flagged Data 


TFIags : Deep Water 1 1 081 ( 2.632%) 

Level 1 : Deep Water, TFIag=0 


AltBadl Flags : 
KuRangCorr Flags : 
CRangCorr Flags : 
GeoBad Flags : 

SSHBad Flags (10/rec) : 
EMBias Flags (2/rec) : 


18598(4.418%) 
10824 ( 2.571%) 
11721 (2.784%) 
7687 ( 1.826%) 
7124 ( 1.692%) 
19(0.005%) 


Dates of Cycle: 1 996-1 84T1 0:1 6:42 to 1 996-1 94T08:05:25 


l/GDR Cycle Summary : Cycle 140 

.imu-.i-p-rn rvm 

-L I l I 1. 



Histogram of SSH Residual RMS, mm 
(Mean=*46.4883, Median=37.95O0) 

l/GDR Cycle Summary : Cycle 140 
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l/GDR Cycle Summary : Cycle 140 
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(MeanaK).0082, Median=0.0100) 
l/GDR Cycle Summary : Cycle 140 
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Histogram of tonoCorr, m 
(Mean =-0.0226, Medi a n«=- 0.0200) 

l/GDR Cycle Summary : Cycle 140 
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Histogram of SigmaOKu, dB 
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Figure A-2 Cycle Summary Plots 
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l/GDR Database : aittrend.current.gdr : All IGDR Data 




l/GDR Database : aittrend.current.gdr : AH IGDR Data 




l/GDR Database : aittrend.current.gdr : All IGDR Data 




l/GDR Database : aittrend.current.gdr : All IGDR Data 



Figure A-3 Trend Plots 



Volume 5, Revision 1 


July 2003 






Standard Products 


TOPEX GDR Processing 



I 

I 


July 2003 


Page A-7 


Volume 5, Revision 1 







moCorr (m) SSHflesid (m) 


TOPEX GDR Processing 


Standard Products 



Volume 5, Revision 1 


July 2003 















Standard Products 


TOPEX GDR Processing 



Page A-9 


Volume 5, Revision t 












AtmosSigma (dB) NetRangeCorrC (m) 



Volume 5, Revision 1 


Page A-10 


July 2003 




Idl (%) 


Standard Products 


TOPEX GDR Processing 


l/GDR database : aiftrend.current.gdr : All IGDR Data 
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Figure A-4 l/GDR Average Plots 
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Figure A-4 l/GDR Average Plots (Continued) 
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Figure A-4 1/GDR Average Plots (Continued) 
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Figure A-4 l/GDR Average Plots (Continued) 
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Figure A*4 l/GDR Average Plots (Continued) 
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Figure A-4 l/GDR Average Plots (Continued) 
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Figure A-4 l/GDR Average Plots (Continued) 
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Table B-1 GDR Software Matrix 


Software 

Data Source 

Products 

Description 

dogdr 

l/GDR Files 

DB Header 
DB Science 
Dump Science 
Print Science 
Avg Science 

Main TOPEX WFF l/GDR Processing 
program. Coded in FORTRAN. 

igdrpass 

Science Avg 

l/GDR Pass Plot 
(Figure A-1 ) 

Unix Script that runs IDL igdrpass.pro. 

autogdr 

l/GDR Files 

DB Header 
DB Science 
l/GDR Pass Plot 

Unix Script that does Automatic 
Retrieval + Daily l/GDR Files from JPL. 

igdrsum 

Avg Science 

Cycle Launch-to- 
Date Trend Plot 
(Figure A-3) 

Unix Script that runs IDL igdrsum.pro. 

igdrdb 

DB Science 

Cycle Summary 
Plot (Figure A-2) 

Unix Script that runs IDL igdrdb.pro. 

igdrdbfilter 

DB Science 

Cycle Summary 
Plot using Specific 
Filter 

Unix Script that runs IDL igdrdb.pro. 

igdravg 

Avg Science 

Science Avg Plot 
(Figure A-4) 

Unix Script that runs IDL igdravg.pro. 


July 2003 


Page B-1 


Volume 5, Revision 1 


































TOPEX GDR Processing 


Software Matrix 



Appendix C 

Format File & Database Contents 


Table C-1 GDR Header Database Format 


Field 


DBCycleNum 


DBPassNum 


KuOn 

COn 


AltOper 


DBCalibRCorrK 



Units 


### 


DBCalibRCorrC 


DBPODQual 

a20 

DBSensorName 

a20 

DBGenSoftName 

a18 

DateRun 

a9 



Description 


Cycle Number 


Pass Number 


Ku Band Status 


C Band Status 


Altimeter A/B Operating 


Altimeter Bias Ku Band Correction from 
Calib ration Correction 


Altimeter Bias C Band Correction from Calibra- 
tion Correction 


Quality of Precision Orbit Determination ‘Interim 
GDR’ 


Name of the Instrument or Hardware Used 


Name of the Program Generating the Data 
Product 


Date the ‘dogdr’ was Run at WFF 


Table C-2 GDR Average Format 


Fmt Units 



Description 


Time past Epoch 


Time in ASCII 


RecCount 

f8.2 

### 

Number of Frames Averaged 

LandWater 

f8.2 


Altimeter Surface Flag 0=Water 1=Land 

WorstMode 

a4 


Current Mode Bits 0-3 

BestMode 

a4 

FTRK 

Current Mode Bits 0-3 

PRGatelndx 

fl 6.3 

### 

Primary (Ku) Gate Index 

SCGatelndx 

f16.3 

### 

Secondary (C) Gate Index 
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Table C-2 GDR Average Format (Continued) 


Description 


Latitude 


Longitude 


SWHAttK 



NetRngCorrC 


Net AGCCorrK 


NetAGCCorrC 


Net SWHCorrK 


NetSWHCorrC 


EarthTide 


OceanTide 


Latitude 


Longitude 


DR (SWH/ATT)Ku 


DR (SWH/ATT) C 


Significant Wave Height K Band 


Significant Wave Height C Band 


Automatic Gain Control K Band 


Automatic Gain Control C Band 


Height of Sea Surface above Ellipsoid 


Height of Sea Surface above Ellipsoid from a 
High Resolution Mean Sea 


Sea Surface Height Residual 


Inverse Barometer Effect Based on Dry-Tropo 
and Latitude 


Altitude of Satellite above the Reference Ellip- 
soid 


Geoid Height above the Reference Ellipsoid 


Sigma Zero Ku 


Sigma Zero C 


EM Bias Correction Ku 


EM Bias Correction C 


Net Instrument Range Correction K Band 


Net Instrument Range Correction C Band 


Net Instrument Automatic Gain Control Correc- 
tion K Band 


Net Instrument Automatic Gain Control Correc- 
tion C Band 


Net Instrument Significant Wave Height Correc- 
tion K Band 


Net Instrument Significant Wave Height Correc- 
tion C Band 


Height of the Solid Earth Tide 


Height of the Elastic Ocean Tide 
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TOPEX GDR Processing 


Table C-2 GDR Average Format (Continued) 



Description 


WetTropoFMO 


WetTropoRad 


lonoCorrRMS 


AltBadl 


AltBad2 


FHgtFlagKu 


FHgtFlagC 


Geocentric Pole Tide Height 


Odd Nadir Angle 


Ocean Loading Effect on Tide 


Atmosphere SigmaO Correction 
Corrected Brightness Temperature, 18 GHz 


Corrected Brightness Temperature, 21 GHz 


Corrected Brightness Temperature, 37 HGHz 


Height of the Elastic Ocean Tide #2 


Ionospheric Correction 


Correction for Dry Tropospheric Delay 


Correction for Wet Tropospheric Delay from 
French Met Office 


Correction for Wet Tropospheric Delay from 
Radiometer Data 


RMS of Ionospheric Delay K Band 


Bit Flags on Altimeter Sensor Corrections 


Bit Flags on Pointing/Seastate Conditions 


Bit Flags on Land Flags and Geophysical Con- 
ditions 


Number of Fine Height Flags Ku 


Number of Fine Height Flags C 


Table C-3 GDR Dump Format 


Fmt Units 


Description 


TEpochSec 


TEpochUTC 


NetTimeTagCorr 


TimeMFD 


LandWater 


Mode(1) 



Time past Epoch 


UTC Time in ASCII 


Net Time Tag Correction = Altimeter Internal 
Delay + Height D 


Time Shift Midframe 


Altimeter Surface Flag 0 = Water 1 = Land 


Current Mode Bits 0-3 
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Table C-3 GDR Dump Format (Continued) 



Description 


Mode (2) 


SigmaOk 


SigmaOC 


OffNadir 


SatAlt 


EMBias CorrK 


EMBiasCorrC 


PoleTide 

SWHAttK 


SWHAttC 


TideLoad 


NetRngCorrC 


SWHPtsAvg 


AGCPtsAvg 


NetAGCCorrK 


NetAGCCorrC 


AGCRMSK 


AGCRMSC 


EarthTide 




OceanTide 


NetSWHCorrK 



Current Mode Bits 0-3 


Sigma Zero Ku 


Sigma Zero C 


Off Nadir Angle 


Altitude of Satellite above the Reference Ellip- 
soid 


EM Bias Correction Ku 


EM Bias Correction C 


Geoid Height above the Reference Ellipsoid 


Geocentric Pole Tide Height 


DR (SWH/ATT)Ku 


DR (SWH/ATT)C 


Ocean Loading Effect on Tide 


Net Instrument Range Correction K Band 


Net Instrument Range Correction C Band 


Number of Points used in Average 


Number of Points used in Average 


Net Instrument Automatic Gain Control Correc- 
tion K Band 


Net Instrument Automatic Gain Control Correc- 
tion C Band 


RMS of Alt AGC Ku Data about AGC Ku Value 


RMS of Alt AGC C Data about AGC AGC C 
Value 


Height of the Solid Earth Tide 


Automatic Gain Control K Band 


Automatic Gain Control C Band 


Significant Wave Height K Band 


Significant Wave Height C Band 


Height of the Elastic Ocean Tide 


Net Instrument Significant Wave Height Correc- 
tion K Band 
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Table C-3 GDR Dump Format (Continued) 


Field 

Fmt 

Units 

Description 


NetSWHCorrC 


SWHRMSK 


SWHRMSC 


PRGatelndx 


SCGatelndx 


Latitude 


BaroCorr 


SSHres 


DryTropo 


WetTropoFMO 


WetTropoRad 


lonoCorr 


SSRMS 


XTrackSurf 


AtmosSigmaO 


TB18 


TB21 


TB37 


SSPtsAvg 


AIIGeoBad 


AIISSHBad 


AlllonoBad 




Net Instrument Significant Wave Height Correc- 
tion C Band 




RMS of Alt SWH C Data about SWH C Value 


Primary (Ku) Gate Index 


Secondary (C) Gate Index 


Latitude 


Longitude 


Height of Sea Surface above Ellipsoid 


Height of Sea Surface above Ellipsoid from a 
High Resolution Mean Sea 


Inverse Barometer Effect based on Dry_Tropo 
and Latitude 


Sea Surface Height Residual 


Correction for Dry Tropospheric Delay 


Correction for Wet Tropospheric Delay from 
French Met Office 


Correction for Wet Tropospheric Delay from 
Radiometer Data 


RMS of Sea Surface Height Rate 


Height of the Elastic Ocean Tide #2 


Atmosphere SigmaO Correction 
Corrected Brightness Temperature, 18 GHz 


Corrected Brightness Temperature, 21 GHz 


Corrected Brightness Temperature, 37 HGHz 


Number of Points used in Average 


All Bit Flags on Land Flags and Geophysical 
Conditions 

All Bit Flags on Invalid Sea Surface Height 
Points 

All Bit Flags on Ionospheric Corrections Out of 
Range 
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Table C-3 GDR Dump Format (Continued) 


Field 

Fmt 

Units 

Description 

AIIAItBadl 

i4 

### 

All Bit Flags on Altimeter Sensor Corrections 

AIIAItBad2 

i4 

### 

All Bit Flags on Pointing/Seastate Conditions 


Name 


TEpochSec 


ATB 


Cycle 


Pass 


RecCount 


PRGatelndx 


SCGatelndx 


Latitude 


Longitude 


SWHAttK 


SWHAttC 


Units Format 


FI 6.3 


A17 


Table C-4 GDR Science Database Format 


Description 


Converted to 2000 Epoch 


UTCTime 


Cycle = 9.92 days 


Pass = 3372.885 seconds 


Nbr frames used in 60 sec avg 


Primary Gate Index 


Secondary Gate Index 


Geodetic Latitude 


East Longitude 


DR(SWH/Att) Ku 


DR(SWH/Att) C 


SWHKu 


SWHC 


Net lnstr AGC Correction Ku 


Net lnstr AGC Correction C 


Net lnstr SWH Correction Ku 


Net lnstr SWH Correction C 


Altitude of Satellite 


Height of Sea Surface above ellipsoid 


Off Nadir Angle 


a SSHgt - OceanTide - SolidTide - PoleTide ■ 
BaroCorr - MeanSSH 


Range Correction for Ionosphere 


Range Correction for EM Bias Ku 


Range Correction for EM Bias C 



NetAGCCorrK 

NetAGCCorrC** 


NetSWHCorrK* 


NetSWHCorrC* 


SatAlt** 


SSHgt 


OffNadir 


SSHres 


lonoCorr 


EMBiasCorrK 


EMBiasCorrC 
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Table C-4 GDR Science Database Format (Continued) 



Name 


SigmaOK 


SigmaOC 


27 NetRngCorrK 


28 NetRngCorrC 


29 AtmosSigmaO 


30 lonoCorrRMS 

31 SSHresRMS 


32 NumGeoBad 


33 NumAltBadl 


34 NumAltBad21 



37 NumSSHBad12 


38 


39 NumFramesDei 


40 NumFineHtKFIg 


41 NumFineHtCFIg 


• New Resolution 
** New Variable 


Format 


Description 


F6.3* Sigma 0 Ku 
Sigma 0 C 


Net Instr Range Correction Ku 


F8.3* Net Instr Range Correction C 


F5.3* Atmospheric Correction to Sigma 0 


F7.3* RMS of lonoCorr (used as HeightKuRMS) 


Linear fit to SSHres 


Count nbr All bits Geo_Bad 


Count nbr All bits Alt_Bad1 


Count nbr ibits(Alt_Bad2, 1,1) 


Count nbr ibits(Alt_Bad2,2,1) 
13 Count nbr ibits(SSH_Bad,0,9) 


13 Count nbr ibits(SSH_Bad, 1 1 ,2) 


13 Count nbr ibits(Alt_Bad1 ,3, 1 ) 

13 Count nbr Frames Deleted 


F5.3* Avg from ibits(lono_Bad, 1 3,1) 


F5.3* Avg from ibits(lono_Bad, 14,1) 


Table C-S GDR Summary Table Format 


Name 


TEpochSec 


ATB 


e 


RecCount 


PRGatelndx 


6 SCGatelndx 


SWHAttK 


SWHAttC 


Format 

Description 

FI 6.3 

Average TEpochSec 

A17 

Average ATB 

A3 

Cycle 

F9.4 

Total RecCount 

F9.4 

Average PRGatelndx 

F9.4 

Average SCGatelndx 

F9.4 

Average SWHAttK 

F9.4 

Average SWHAttC 
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I 

Table C-5 GDR Summary Table Format (Continued) I 


Field 

Name 

Units 

Format 

Description 

9 

SWHK 

m 

F9.4 

Average SWH K 

10 

SWHC* 

m 

F9.4 

Average SWH C 

ii 

NetAGCCorrK 

mi 

F9.4 

Average NetAGCCorrK 

12 

NetAGCCorrC* 

db 

F9.4 

Average NetAGCCorrC 

13 

NetSWHCorrK* 

m 

F9.4 

Average NetSWHCorrK 

14 

NetSWHCorrC* 

mi 

F9.4 

Average NetSWHCorrC 

■a 

SatAlt* 


FI 4.4 

Average SatAlt 

■a 

SSHgt 

■H 

F9.4 

Average SSHgt 

j 

OffNadirA** 

mi 

F9.4 

Average OffNadirA 

urn 

OffNadirB** 

deg 

F9.4 

Average OffNadirB 

19 

SSHres 

m 

F9.4 

Average SSHres 

20 

lonoCorr 

■ 


Average lonoCorr 

21 

EMBiasCorrK 

mi 

F9.4 

Average EMBiasCorrK 

22 

EMBiasCorrC 

m 

F9.4 

Average EMBiasCorrC 

23 

SigmaOK 

db 

F9.4 

Average SigmaOK 

24 

SigmaOC 

db 

F9.4 

Average SigmaOC 

25 

NetRngCorrK 

mi 

F9.4 

Average NetRngCorrK 

26 

NetRngCorrC 

m 

F9.4 

Average NetRngCorrC 

27 

AtmosSigmaO 

db 

F9.4 

Average AtmosSigmaO 

28 

lonoCorrRMS 

mm 

F9.4 

Average lonoCorrRMS) 

29 

SSHresRMS 

mm 

F9.4 

Average SSHresRMS 

30 

GeoBad 

% 

F9.4 

Total GeoBad / RecCount * 100.0 

31 

AltBadl 

% 

F9.4 

Total AltBadl / RecCount * 100.0 

32 

AltBad21 

% 

F9.4 

Total AltBad21 / RecCount * 100.0 

33 

AltBad22 

% 

F9.4 

Total AltBad22 / RecCount * 100.0 

34 

SSHBad09 

% 

F9.4 

Total SSHBad09 / RecCount * 100.0 

35 

SSHBad12 

% 

F9.4 

Total SSHBadl 2 /RecCount * 100.0) 

36 

TFIags 

% 

F9.4 

Total TFIags / RecCount * 100.0 

37 

FramesDel 

% 

F9.4 

Total FramesDel / RecCount * 100.0 

38 

ONAEdit 

% 

F9.4 

Total OffNadir Deleted/ RecCount * 100.0 
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Format File & Database Contents 


TOPEX GDR Processing 


Table C-5 GDR Summary Table Format (Continued) 


Held 

Name 

Units 

Format 

Description 

39 

TotEdit 

% 

F9.4 

Total remaining after filter / RecCount • 100.0 


* New Variable 

** OffNadir A: if it were an ascending pass in the northern hemisphere (>5 deg and <60 deg latitude) 
OR if it were a descending pass in the southeren hemisphere (<-5 deg and >-60 deg latitude); in 
either event, the range-rate is positive. OffNadir B: if it were a descending pass in the northern hemi- 
sphere (>5 deg and <60 deg latitude) OR if it were an ascending pass in the southern hemisphere 
(<-5 deg and >-60 deg latitude); in either event, the range-rate is negative. 
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Format File & Database Contents 




Appendix D 

l/GDR Software Change History 


Table D-1 GDR Software Change History 



First 

Date 

Effectiv 

e 


Related 

Request 

s 


Software 

Components 


New Version 


Description 


4/01/94 


6/02/94 


(l)GDR Processing Officially Placed Under Control, Memo April 1, 1994, Hayden Gordon 


Cycle 62 94/076 


IGDREUConv.f 


SSH Residual Correction 


9/02/94 

Cycle 70 

n/a 

igdrdb.pro 

igdrsum.pro 

n/a 

SSHResRMS Plot Scale 
Change 

9/16/94 

Cycle 70 

n/a 

igdrpass.pro 

n/a 

Pass Plot Correction 

9/23/94 

Cycle 73 

n/a 

igdrdb.pro 

n/a 

Certain Editing Criteria 
Modifications on 
Summary Database 

2/15/95 

n/a 

95/046 

95/017 

95/026 

igdrsum.pro 

n/a 

Modify Vertical Scales on 
Launch-to-Date Plots 

9/11/95 

Cycle 109 

95/149 

GDRDBAvg.f 

1.2,9/11/95 

doGDR.f 

GEO_BAD Flagging of 
Non-Zeros 

8/26/96 

Cycle 1 33 

96/010 

96/146 

GDRDBAvg.f 

GDRAvg.f 

IGDRREUConv.f 

readigdr.pro 

readigdravg.pro 

1.3,8/26/96 

doGDR.f 

Per Change Requests 
for SDS GDR Upgrades 
: fromJPL 
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Appendix E 

Attachments 


l 

I 

I 


Table E-1 Attachments 


Date 

Author(s) 

Subject 

December 8, 1 992 

R.L. Brooks 

(1) GDR Summary Plots and Data Base 
Definition 

June 1, 1993 

H. Gordon 

Current State of SWDT Software 

September 17, 1993 

H. Gordon 

Some Suggested Standard IGDR Data- 
base Products 

September 24, 1993 

R.L. Brooks 

Contents of (l)GDR Data Base 

February 15, 1994 

J. Lee 

Re: Request 95/046 

March 29, 1994 

D.Lockwood, J. Lee 

l/GDR Processing 

April 1, 1994 

H. Gordon 

Change Control Status for (l)GDR Pro- 
cessing Module 

April 11, 1994 

H. Gordon 

Change to (l)GDR Processing Module: 
SSH Residual Correction 

May 4, 1994 

R. Brooks 

SSH Residual Computations 

May 23, 1994 

R. Brooks 

Reference for Rapp Modification to 
Mean_Sea_Surf 

June 2, 1994 

H. Gordon 

EA S/W Chg 14:SSH Residual Correction 

August 10, 1994 

R. Brooks 

Changing the Scale of the SSH Residual 
RMS Histogram within the (l)GDR Cycle 
Summary 

August 10, 1994 

R. Brooks 

Change in (l)GDR Data Base 

August 10, 1994 

R. Brooks 

Applying Calibration Corrections to (l)GDR 
Data Retrieval Products 

August 10, 1994 

R. Brooks 

Change in Summary (l)GDR Data Base 

August 11,1 994 

R. Brooks 

Changing the Scale of the SSHResidu- 
alsRMS Plot Within the (l)GDR Launch-to- 
Date Summary 

August 12, 1994 

H. Gordon 

Change to (l)GDR Processing Module: 
SSHResRMS Plot Scale Changes 

August 12, 1994 

H. Gordon 

Change to (l)GDR Processing Module: 
Apply CAL Corrections 
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TOP EX GDR Processing 


Table E-1 Atta 

Date Authors) 

August 1 2, 1 994 H. Gordon 

September 9, 1994 H. Gordon 

September 9, 1994 H. Gordon 

September 9, 1994 H. Gordon 

September 21,1 994 H. Gordon 

September 21,1 994 H. Gordon 

October 28, 1 994 D. Lockwood, J. Lee 

October 31,1 994 H. Gordon 

February 3, 1995 R. Brooks 

March 15,1 995 H. Gordon 

September 29, 1995 H. Gordon 

December 21 , 1 995 P.S. Callahan/JPL 
March 14, 1996 D. Lockwood, J. Lee 

March 29, 1996 D. Lockwood, J. Lee 

September 5, 1 996 D. Lockwood, J. Lee 
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Attachments 


I 


nents (Continued) 


Subject 


Change to (l)GDR Processing Module: 
Database Additions 


Change to (l)GDR Processing Module: 
Pass Plot Correction 

EA S/W Chg 18: SSHResRMS Plot Scale 
Changes 

EA S/W Chg 16: Summary Database 
Additions 


EA S/W Chg 21: (l)GDR Pass Plot Correc- 
tion 


Change to (l)GDR Summary Database: 1 0 
Editing & Scale Revisions 

GDR Cycles 1-8 Absence 

GDR Cycles 1-8, Clarification 

TOPEX Software Modification 



Request #95/046 - GDR Launch-to-Date 
Cycle Summary Plot Scale Change 


Request #95/149 - Geo_Bad Bits 


Change Requests for SDS GDR Upgrades 


Request #96/010 - GDR s/w Change 
Study 


Addendum to Request #96/010 GDR s/w 
Change Study 


Change Request 96/146 - Software 
Change Requests 



























To: Distribution 
From: Ron Brooks 
Date: December 8, 1992 

Subject: (I)GDR Summary Plots and Data Base Definition 

The proposed contents of the (I)GDR summary plots and (I)GDR data 
base are attached, for your review and comment . 


Distribution : 

David Hancock 
George Hayne 
Ron Forsythe 
Hayden Gordon 
Jeff Lee 
Dennis Lockwood 



Standard (I) GDR Pass Summary IDL Plots 


Plot Labels 
CYC LE_NUMBER_VALUE 
PAS S_NUMBER_VALUE 
REV_NUMBER_VALUE 
T I ME_F IRS T_P T_VALUE 

Plot Parameters vs. elapsed time in seconds from start of pass 
ALT_BAD2 

ATMOS_S I GMAO_CORR 

CURRENT_MODE 

DR ( SWH/ATT ) _C 

DR(SWH/ATT)_K 

EM_B I AS_CORR_C 

EM_B I AS_CORR_K 

GATE_INDEX 

GEO ID 

GEOJBAD 

IONO CORR 

NE T I N S TR_AGC_CORR_C 

NE T INS TR__AGC_CORR_K 

NET INSTR_R_CORR_C 

NET INSTR__R_CORR_K 

NET INSTR_SWH_CORR_C 

NET_INSTR_SWH_CORR_K 

OFF_NAD I R__ANGLE 

SEA_SURF_HGHT 

SIGMA_0_C 

SIGMA_0_K 

SWH_C 

SWH K 


(I)GDR Values for Data Base 


Pass Header 
CYCLE_NUMBER_VALUE 
PAS S_NUMBER_VALUE 
GENERATING_SOFTWARE_NAME_VALUE 
P OD_QUAL_VALUE 

SENSOR_NAME_VALUE delete pass if not = "ALT" 

CAL I B_R_CORR_C_VALUE 
CAL I B_R_CORR_K_VALUE 

Entries @ 1 minute rate 
AGC_C and AGC_K 
ALT_BAD1 and ALT_BAD2 
ATMOS_S IGMAO__CORR 

CURRENT_MODE delete frame if not = "track" 

DR ( S WH / ATT ) _C and DR (SWH/ATT)_K 
DRY_TROPO 

EM_B I AS_CORR_C and EM_B IAS_CORR_K 

GATE_INDEX 

GEOID 

GEO_BAD delete frame if surface flag = "land" 

INS TR_S TATE 

IONO_BAD 

IONO_CORR 

LATITUDE 

LONGITUDE 

NE T_I NS TR_AGC_CORR__C and NET_INSTR_AGC_CORR_K 

NET_IN S TR_R_CORR_C and NET_INSTR_R_CORR_K 

NET_INS TR_S WH_CORR_C and NE T_INS TR_SWH_CORR_K 

NET_T IME_TAG_CORR 

OCEAN_TIDE 

OFF_NAD IR_ANGLE 

PFLAG 

POLE_TIDE 

SAT_ALT 

SEA_SURF_HGHT 

SIGMA_0_C and SIGMA_0_K 

SOLI D_EARTH_T IDE 

SSH_BAD 

SWH_C and SWH_K 

TIME = TIME_EPOCH_VALUE + TIME_PAST_EPOCH 

TIME_SHIFT_MIDFRAME 

WET TROPO FMO and WET TROPO RAD 



TOPEX InterOffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock 

From: Hayden Gordon 

Date: June 1, 1993 

Subject: Current State of S WDT Software - Your Feedback Needed! 

Attached please fine a summary, generated by Jeff Lee, of the revised S WDT processing strategy and the 
status of SWDT production software. Both items reflect information gathered at the recent IGDR 
database meetings, and the iterations which have occurred as a result. Please address the open items, 
especially those marked with the *** Item *** designator. You may respond directly back to Jeff in 
written form (preferred) or verbally. 

Note that, as of today, the new version of 'dotelem' is being used for production, including the new RMS 
calculation and temperature correction for the CAL-mode AGC. 

Thank you for your timely consideration of these open items. The software is shaping up quickly, and 
should serve the needs of the WFF TOPEX community well over the long haul. 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 




Revised TQPEX Data Processing Strategy 


Altimeter Instrument Files (AIF) 

Processing & Storage 

Retrieved from JPL daily. Stored at WFF on Exabytes. 

Daily Products 
CAL Plots 
ENG Plots 
Event Reports 
Processing Summary 

*** If we do weekly launch-to-date plots, can we cut down the number of pages on 
the daily engineering plots ? *** 

Periodic Products 

Weekly Launch-to-Date CAL Summary 
Weekly Launch- to-Date ENG Summary 
On-Request Launch-to-Date SEU Summary 
Other Products 
None 


Sensor Data Records (SDR) 

Processing & Storage 

Received from JPL on Exabyte. Stored same. 

Daily Products 

None 

Periodic Products 
None 

Other Products 
None 

Geophysical Data Records (l/GDR) 

Processing & Storage 

Received from JPL Daily. Also from JPL on Exabyte. Stored on Exabyte. 
Daily Products 

GDR Daily Plot. *** Needs Definition *** 

Periodic Products 

Per-Cycle Summary Plots. *** Needs Definition *** 

Other Products 

Reference Plots for repeating measurements *** Needs Definition *** 


TQPEX Data Processing Status 


dotelem 

Has been updated to use new Hgt RMS method and to create database files. Need to 
know what other height (besides Ku — Ku/C/Combined/Diff) to save, 
dosdr 

Has been updated to use new Hgt RMS method, 
dogdr 

Ready for testing and sizing requirements. 



TOPEX InterOffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy, Larry Rossi. 

Jeff Lee, Dennis Lockwood 

From: Hayden Gordon 

Date: September 17, 1993 

Subject: Some Suggested Standard IGDR Database Products 

Attached please find a "first-cut" at some standard products which should be available from the (I)GDR 
database, per Dave Hancock, with additional notes from Ron Brooks. There will be a meeting on 
Tuesday, Sept. 21 at 1:30 PM (after the regular 1 PM ADT meeting) in the N 159 conference room to 
discuss and revise these products. 



To: Distribution 

From: Ron Brooks 

Date: September 24, 1993 

Subject: Contents of (I)GDR Data Base 

One of the action items which emanated from the 9/22/93 meeting 
on (I)GDR data base standard products was the documenting of the 
contents of the data base. 

The first attachment, courtesy of George Hayne, describes the 
data base contents in terms of parameters and the precision 
associated with each parameter. The second attachment, courtesy 
of Jeff Lee, depicts the flowchart logic for setting the flags in 
the data base. 


Distribution : 

Ron Forsythe 
Hayden Gordon 
David Hancock 
George Hayne 
Jeff Lee 
Dennis Lockwood 
Craig Purdy 
Larry Rossi 



Description of records in IGDR database (1-min averaqes) 
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IGDR Flagging Flowchart 


Thu. Sep 23. 1993 


11:53 AM 






T o : CSC / Hayden Gordon 

From: CSC /Jeff Lee 

Date: February 15, 1994 

Subject: RE> Request 95/046 

Software Development 
Team 

TOPEX Project 
NASA GSFC/WFF 



In response to Request#95/ 046, changes have been made to the following 
components of the GDR processing system: 

igdrsum no version number Changed plot scales 

readigdrsum no version number Changed plot labels 

All changes are completed and new software is in place as of 02/15/9 5. Sample 
products are attached. 


Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To: 

From: 

Date: 

Subject: 


CSC/Hayden Gordon 
CSC / Der^^iki^M^ood, 
March 29, 1994 
1/ GDR Processing. 



Attached are listings of the database structures and sample output products from the 
I/GDR Standard processing. The processing methodology, database structure, 
processing software, and plotting software are hereby under change control. No 
modifications, additions, or deletions will be made to this system without the proper 
(TBD) authorization. 

Processing Methodolog y. 

1. Daily, IGDRs are retrieved automatically from JPL starting at 3AM Eastern Time. 

2. Daily, dogdr is automatically run on the retrieved data and produces the 
following output files : 

a. 10-second Science Averages for daily plotting. 

b. 1-Minute Science Averages for database. 

c. Header (Processing summary) listing for database. 

3. Daily, various programs are automatically run in IDL to produce the following 
output products : 

a. IGDR Pass Plots. (For each new IGDR pass) 

4. At irregular intervals, database files are loaded into the master database and the 
following output products are generated : 

a. none. 

4. Upon receipt of a GDR tape from JPL, dogdr is re-run on the GDR data. Old data 

are deleted from the databases and the new GDR data are loaded. The new data 
are then extracted and the following output products are generated: 


a. Cycle Summary Plots (for each new GDR cycle). 

b. Launch-to-Date GDR Trend Plots 


Attached are listing of the database structures and sample output products. 
Attachment A contains the structure of the databases. Attachment B contains a sample 
of the IGDR Pass plot. Attachment C contains a sample of the per-cycle plots. 
Appendix D is a list of software and datafile titles put under change control by this (or 
some previous) memo. 


Attachment A: Database Structures 


Structure for database: 

Number of data records: 
Date of last update: 

Databases: 

13020 

03/21/94 

Tvoe 

TOPEX IGDR Databases : header .dbf 

Width Dei 

1 

cycle 

Numeric 

3 

2 

pass 

Numeric 

3 

3 

kuon 

Character 

3 

4 

con 

Character 

3 

5 

altoper 

Character 

1 

6 

calrcorku 

Character 

7 

7 

calrcorc 

Character 

7 

8 

podgual 

Character 

20 

9 

dbsensor 

Character 

20 

10 

gensoft 

Character 

18 

11 

wf fproc 

Character 

9 

** Total ** 

95 




structure for database: 

Number of data records : 
Date of last update: 

Field F i e 1 d Name 

Databases: 

43 

03 / 08/94 

Tvoe 

TOPEX IGDR 
Width 

Databases : summary .dbf 

Dec 

1 

timesec 

Numeric 

16 

3 

2 

utctime 

Character 

17 


3 

cycle 

Numeric 

3 


4 

reccount 

Numeric 

9 

4 

5 

prgate 

Numeric 

9 

4 

6 

scgate 

Numeric 

9 

4 

7 

swhattku 

Numeric 

9 

4 

8 

swhattc 

Numeric 

9 

4 

9 

swhku 

Numeric 

9 

4 

10 

agccorrku 

Numeric 

9 

4 

11 

ssh 

Numeric 

9 

4 

12 

of fnadir 

Numeric 

9 

4 

13 

sshresid 

Numeric 

9 

4 

14 

ionocorr 

Numeric 

9 

4 

15 

embiasku 

Numeric 

9 

4 

16 

embiasc 

Numeric 

9 

4 

17 

sigmaOku 

Numeric 

9 

4 

18 

sigmaOc 

Numeric 

9 

4 

19 

rangecorku 

Numeric 

9 

4 

20 

rangecorc 

Numeric 

9 

4 

21 

sigma 0 

Numeric 

9 

4 

22 

sshresrms 

Numeric 

9 

4 

23 

hgtkurms 

Numeric 

9 

4 

24 

geobad 

Numeric 

9 

4 

25 

altbadl 

Numeric 

9 

4 

26 

altbad21 

Numeric 

9 

4 

27 

altbad22 

Numeric 

9 

4 

28 

sshbad09 

Numeric 

9 

4 

29 

sshbadl2 

Numeric 

9 

4 

30 

tf lags 

Numeric 

9 

4 

31 framesdel 

** Total ** 289 

Numeric 

9 

4 



Structure for database: 

Number of data records : 
Date of last update: 

Field Field Name 

Databases : 

382260 
03/29/94 
Type 

TOPEX IGDR 

Width 

Databases 

Dec 

1 

t imesec 

Numeric 

16 

3 

2 

utctime 

Character 

17 


3 

cycle 

Numeric 

3 


4 

pass 

Numeric 

3 


5 

reccount 

Numeric 

4 

1 

6 

prgate 

Numeric 

3 

1 

7 

scgate 

Numeric 

3 

1 

8 

latitude 

Numeric 

6 

2 

9 

longitude 

Numeric 

6 

2 

10 

swhattku 

Numeric 

7 

2 

11 

swhattc 

Numeric 

7 

2 

12 

swhku 

Numeric 

4 

1 

13 

agccorrku 

Numeric 

6 

2 

14 

ssh 

Numeric 

7 

2 

15 

of fnadir 

Numeric 

4 

2 

16 

sshresid 

Numeric 

8 

2 

17 

ionocorr 

Numeric 

7 

2 

18 

embiasku 

Numeric 

7 

2 

19 

embiasc 

Numeric 

7 

2 

20 

sigma Oku 

Numeric 

5 

2 

21 

sigmaOc 

Numeric 

5 

2 

22 

rangecorku 

Numeric 

7 

2 

23 

rangecorc 

Numeric 

7 

2 

24 

sigmaO 

Numeric 

4 

2 

25 

sshresrms 

Numeric 

6 

2 

26 

hgtkurms 

Numeric 

6 

2 

27 

geobad 

Numeric 

3 


28 

altbadl 

Numeric 

3 


29 

altbad21 

Numeric 

3 


30 

altbad22 

Numeric 

3 


31 

sshbad09 

Numeric 

3 


32 

sshbadl2 

Numeric 

3 


33 

tf lags 

Numeric 

3 


34 

** Total ** 

framesdel 

190 

Numeric 

3 



Attachment B: Samples of Per-Pass Plot Product 







Attachment C: Samples of Per-Cycle Plot Product 



Percentage of Good Data Percentage of Good Data Percentage of Good Data 


l/GDR Cycle Summary : Cycle 50 

1 -Minute Averages from IGDR Database 

Processing Summary Flagging Summary 


Level 0 : All Data 

Records Processed : 885044 

Level 1 : Deep Water, TFlag=0 
Records Processed : 869893 

Records Deleted : 15151 ( 1.851%) 

Level 2 : Level 1, AltBadx=0 

Records Processed : 81 8330 

Records Deleted : 51563 ( 6.301%) 


TFIags : Deep Water 15151 ( 1.851%) 

Level 1 : Deep Water,TFIag=0 

AltBadl Flags : 23921 ( 2.923%) 

KuRangCorr Flags : 14083 ( 1.721%) 

CRangCorr Flags : 13740 ( 1 .679%) 

GeoBad Flags : 201 72 ( 2.465%) 

SSHBad Flags (10/rec) : 6029 ( 0.737%) 

EMBias Flags (2/rec) : 42 ( 0.005%) 


Good Data = Remainder After Removing Level-2 Flagged Data 


Dates of Cycle: 1994-022T00:26:21 to 1994-031 T22:24: 16 


l/GDR Cycle Summary : Cycle 50 



0 10 20 30 40 50 60 

Histogram of HgtKuRMS, mm 
(Mean *1 8.4047, Median =17.7300) 

l/GDR Cycle Summary : Cycle 50 



o 10 20 30 40 

Histogram of SSH Residual RMS, mm 
(Mean=4.8061, Median =2.34 00) 

l/GDR Cycle Summary : Cycle 50 



-0.25 -0.20 -0.15 -0.10 -0.05 0.00 0.05 

Histogram of lonoCorr, m 
(Mean =-0.0377, Median=-0.0300) 


l/GDR Cycle Summary : Cycle 50 



-1.5 -1.0 -0.5 0.0 0.5 1.0 1.5 

Histogram of SSH Residual, m 
(Mean=-0.0121, Median=0.0100) 
l/GDR Cycle Summary : Cycle 50 



0 10 20 30 40 50 

Cumulative Histogram of SSHBad09, Occurrences 
(Mean=0.3789, Median=0.0000) 

l/GDR Cycle Summary : Cycle 50 



-0.25 -0.20 -0.15 -0.10 -0.05 O.00 0.05 


Cumulative Histogram of lonoCorr. m 








Percentage of Good Data Percentage of Good Data Percentage of Good Data Percentage of Good Data 



ETJB51 KfiawM \ 








I/GDR Cycle Summary : Cycle 50 



l/GDR Cycle Summary : Cycle 50 



Histogram ot AtmosSigma (dB) 
(Mean=0.2235, Median =0.21 00) 

l/GDR Cycle Summary : Cycle 50 


SWHKu. m 

l/GDR Cycle Summary : Cycle 50 


* . T t+. 


1 2 3 4 5 

0.00 

0.10 0.20 0.30 

Primary Gate Index 


Off Nadir Angle 

l/GDR Cycle Summary : Cycle 50 


l/GDR Cycle Summary : Cycle 50 


SWHKu, m 


Local Time 












l/GDR Database : ToCycleS3.igdr : All IGOR Data 








NolAOCOoriKu 




































30 40 50 

Cycle 

l/GDR Database : ToCycle53Jgdr : All IGDR Data 




Attachment D: Software Under Change Control 


FORTRAN source code 

1. topextime.lib 

2. topexgdr.lib 

3. topexgeneral.lib 

4. dogdr 

Datafiles 

1. none. 

IDL code 

1. igdrpass.pro 

2. igdrdb.pro 

3. igdrsum.pro 



TOPEX InterOffice Memo 


To: Ron Brooks, Ron Forsythe, George Hnyne, David Hancock, Craig Purdy 

From: Hayden Gordon 

Date: April 1, 1994 

Subject: Change Control Status for (I)GDR Processing Module 

By this memo, the NASA Radar Altimeter (Interim) Geophysical Data Record ((I)GDR) processing 
module and associated standard data products are considered baselined and placed under change control; 
changes affecting any of the baselined software will be handled according to the TOPEX Software 
Development Team (SWDT) change control policy (stated below). 

Attached is a summary of the functions performed by the module, the database structures, a sample of the 
standard products generated, and a list of the source code and data files affected. 


SWDT Chanpe Control Policy 

Any changes to SWDT baselined software, under change control, will be handled according to the 
following process: 

1. A memo describing the requested change will be generated and circulated to all members of the 
TOPEX Algorithm Development Team (ADT), and to the SWDT (for implementation 
comments). 

2. The memo will be discussed at a meeting (regular or special) of the ADT, at which time any 
special implementation comments (from the SWDT) will be .considered. If the change is 
approved by the ADT, a priority will be assigned. The process will not proceed beyond this step 
until ADT approval is secured 

3. An SWDT Work Request will be generated, signed by the NASA SWDT manager, and attached 
as a cover to the original memo. 

4. The SWDT request will be given a title, EA S/W Chg #, and processed in the normal manner. 

5. When the request is completed, a brief memo will be generated by the SWDT to summarize the 
change, to date the change (the date when implemented and the date when the change will 
appear in the data), and to list the affected routines and data files. Any new or modified 
products will be attached, if applicable. The implementation memo will be delivered to all 
members of the ADT, and the process will be complete. 


CC: Jeff Lee, Dennis Lockwood, Carol Purdy 




TOPEX InterOffice Memo 


To: Ron Brooks, Rou Forsythe, George Hayne, David Hancock 

From: Hayden Gordon 

Date: April 11, 1994 

Subject: Change to (I)GDR Processing Module: SSH Residual Correction 

Attached is a memo from Dennis Lockwood & Jeff Lee which addresses an error in the implemented 
computation the Sea Surface Height (SSH) Residual in the baselined (I)GDR processing module. A 
recommended approach to correct the problem is outlined in the request. Please consider the request, 
provide written comments if desired, and we will discuss it for possible implementation at the next ADT 
meeting. 

Thanks, 


CC: Jeff Lee, Dennis Lockwood, Carol Purdy 


!rd< 



Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To: 

From: 

Date: 

Subject: 


CSC/Hayden£^rdoh 
CSC/Demd^Bo^wood,CSwl€ 

April 5, 1994 
Suggested Correction to I/GDR Processing. 


In testing alternate methods for computing Sea Surface Height Residual (SSHRes), 
we have discovered a programming error in the current computation. Incorrect 
values for SeaSurfHgt and MeanSeaSurf are being used in the computation. This 
renders the SSHRes invalid. 

We recommend that the GDR processing module, dogdr be modified to use the 
correct values for SeaSurfHgt and MeanSeaSurf. Furthermore, all standard plots 
must be modified to reflect new scales for SSHRes and SSHRes RMS. The TOPEX 
team must also decide if it will be necessary to go back and re-prOcess all the GDR 
data since the data in the database is not valid. 

Since dogdr is change-controlled software, this memo is to advise the team of a 
problem and offer a suggested correction. A software change notice will be 
required in order to fix the problem and testing will have to be done to determine 
new scales for the standard GDR plots. 


To: Distribution 
From: Ron Brooks 
Date: May 4, 1994 

Subject: SSH Residual Computations 

Reference: H. Gordon Memorandum of April 11, 1994 

Hayden's memorandum states that there was an implementation error 
in the computation of the SSH residuals. In response to an ADT 
Action Item, Dennis Lockwood and I have worked towards: 

1. Testing the revised code. 

2. Assessing the Rapp modification to the mean sea surface. 


Code Revision and Testing 

The Sea_Surf_Hght residual (SSHres) is computed as: 

SSHres (mm) — Sea_Surf_Hght - Ocean_Tide - Solid_Earth_Tide - 

Pole_Tide - Baro_Corr - Mean_Sea_Surf 

All of these are directly accessible from the IGDR file, except 
for Baro_Corr, the inverse barometer effect. Baro_Corr is based., 
on Dry_Tropo and Latitude from the IGDR file as: 

Baro_Corr (mm) = 

-10 . 1 [DryJTropo/ (-2.273 (1+0 . 0026*cos (2*Latitude) ) ) -1013.3] 

In the original implementation, Sea_Surf_Hght and Mean_Sea_Surf • 
were inadvertently set to zero, and thus the computed SSHres 
values were quite small. 

Dennis changed the code in his software test bed, • and provided 
spreadsheet values to me for independent testing. I was able to 
verify that the new code is working satisfactorily. 

Using the new code, SSHres mean and rms values were computed for 
three cycles: 10, 30, and 50. The results were: 

Cycle 10 Mean = +388.3 mm RMS = 92.2 mm 

Cycle 30 Mean = +402.6 mm RMS = 93.2 mm 

Cycle 50 Mean = +398.7 mm RMS = 92.4 mm 


Rapp Revision to Mean Sea Surface 


Richard Rapp has derived a 


latitude/longitude dependent 



correction to the (I)GDR mean sea surface values where 


Mean_Sea_Surf_Rapp = Mean_Sea_Surf + dR + dX cgsdat) cos (long) + 
dY cos(lat) sin (long) + dZ sin(lat). 

Rapp's initial coefficients are: dR=+40Q mm, dX=0, dY=+240 nun, 

and dZ=0. 


As before, Dennis implemented the appropriate test bed code and 
provided a spreadsheet for verification. I verified that the 
code for the Rapp modification was working correctly. 


Using the Rapp-modification code, 
again computed for three cycles: 
were : 

Cycle 10 Mean = +2.3 mm 
Cycle 30 Mean = +18.6 mm 
Cycle 50 Mean - +12.3 mm 


SSHres mean and rms values were 
10, 30, and 50. The results 


RMS = 92.2 mm 
RMS = 93.2 mm 
RMS = 92.4 mm 


Recommendation 


The Rapp modification primarily compensates for a bias of 400 mm 
between the TOPEX-derived sea surface heights and the mean sea 
surface heights on the (i)GDR tapes; there is a smaller, 
geographically-correlated mean height correction. As long as we 
have consistent cycle-to-cycle geographic coverage, it shouldn't 
matter which of the two methods of computing SSHres is used; we 
can still look at the relative cycle-to-cycle changes. 

However, if we wish to trace the SSHres pattern back to the early 
cycles when there was intra-cycle altimeter sharing and non- 
uniform geographic coverage, we should use the modified Rapp 
method. Based on my impression that we will want to examine the 
trends over a longer term, I recommend that the modified Rapp 
computations be implemented in the data base processing. 


cc: 

Ron Forsythe 
Hayden Gordon 
George Hayne 
David Hancock 
Jeff Lee 
Dennis Lockwood 



To: Distribution 
From: Ron Brooks 
Date: May 23, 1994 

Subject: Reference for Rapp Modification to Mean_Sea_Surf 


A modification to Mean_Sea_Surf in the TOPEX data base is being 
implemented. Mean__Sea_Surf is used to calculate SSHres. 

The modification is based on Richard Rapp 7 s derivation where: 

Me an_S e a_S ur f _Rapp = Mean_Sea_Surf + dR + dX cos(lat) cos (long) + 
dY cos(lat) sin (long) + dZ sin(lat). 

Rapp's initial coefficients are: dR=+400 mm, dX=0, dY=+240 mm, 

and dZ=0 . 

The referenced source of this equation is Section 3.4.3 of the 
GDR Users Handbook. 


cc: 

Ron Forsythe 
Hayden Gordon 
George Hayne 
David Hancock 
Jeff Lee 
Dennis Lockwood 



TOPEX InterOfSce Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

From: Hayden Gordon 

Date: June 2, 1994 

Subject: EA S/W Chg 14: SSH Residual Correction 

Attached is a memo from Dennis Lockwood & Jeff Lee which addresses an error in the implemented 
computation of the Sea Surface Height (SSH) Residual in the baselined (I)GDR Processing Module. This 
change, designated Engineering Assessment Software Change Request 14, has been completed. The 
programming error was corrected, the old calculation method commented out in the code, and the Rapp 
calculation method inserted. The attached paperwork from Ron Brooks explains the Rapp calculation of 
SSH Residual, shows some results from testing, and documents the source of die Rapp method. The 
software change is effective June 1, 1994, and the IGDRs arriving from JPL beginning June 2 (IGDR 
Cycle 62, Pass70) will be processed with the new software. No standard products have been affected; the 
data will display properly on existing graphs without any scale change. Upon direction from the ADT, 
reprocessing of all GDRs will commence, and should take from 30 to 45 days to complete. 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 





Software Development Team 
TOPEX Project 
NASA GSFC/WFF 



In testing alternate methods for computing Sea Surface Height Residual (SSHRes), 
we have discovered a programming error in the current computation. Incorrect 
values for SeaSurfHgt and MeanSeaSurf are being used in the computation. This 
renders the SSHRes invalid. 

We recommend that the GDR processing module, dogdr be modified to use the 
correct values for SeaSurfHgt and MeanSeaSurf. Furthermore, all standard plots 
must be modified to reflect new scales for SSHRes and SSHRes RMS. The TOPEX 
team must also decide if it will be necessary to go back and re-process all the GDR 
data since the data in the database is not valid. 

Since dogdr is change-controlled software, this memo is to advise the team of a 
problem and offer a suggested correction. A Software change notice will be 
required in order to fix the problem and testing will have to be done to determine 
new scales for the standard GDR plots. 


To : Hayden Gordon 
From : Ron Brooks 
Date: August 10, 1994 

Subject: Changing the Scale of the SSH Residual RMS Histogram within the 
(I)GDR Cycle Summary 


A software change is requested, to accomplish the following: 

Change the scale of the SSH Residual RMS histogram plot within the 
(I)GDR Cycle Summary . Suggested scale changes, based on the 

results of Dennis- Lockwood ’ s studies are: 

0-8 for the vertical scale 
0-300 for the horizontal scale 
Bin size of 5 


cc: 

David Hancock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 



To 2 Hayden Gordon 

From: Ron Brooks 

Date: August 10, 1994 

Subject: Change in (I)GDR Data Base 

Software changes for the (I)GDR data base program are requested, to 
accomplish the following: 

1* Assign identifiers "a" or "b* to the one-minute segments in 
the (I)GDR data base. The segment would be an - a" if it 
were an ascending pass in the northern hemisphere (>5 deg 
and <60 deg latitude) OR if it were a descending pass in the 
southern hemisphere (<-5 deg and >-60 deg latitude); in 
either event, the range-rate is positive. The segment would 
be a ■b* if it were a descending pass in the northern 
hemisphere (>5 deg and <60 deg latitude) OR if it were an 
ascending pass in the southern hemisphere (<-5 deg and >-60 
deg latitude); in either event, the range-rate is negative. 

2. For Off-Nadir Angle in the (I)GDR data base, store the 
median rather than the mean value. 


CC : 

David Hancock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 



To: Hayden Gordon 
From: Ron Brooks 
Date: August 10, 1994 

Subject: Applying Calibration Corrections to (I)GDR Data 
Retrieval Products 

A software change is requested, to accomplish the following: 

Apply, as a part of routine processing, time-varying calibration 
corrections to standard retrieval products from the (I)GDR data 
base. AGC corrections would be added to sigma-naught - SWH 
corrections would be added to SWH. Height corrections would be 
subtracted from sea surface height. 

For example, there presently exists a table of AGC calibration 
corrections which is periodically updated. Some of these corrections 
have been already applied (by the TGS ) to the altimeter measurements; 
others have not. We would wish to routinely apply these remaining 
corrections to the sigma-naught retrieval products from the (I)GDR data 
base . 

It is anticipated that similar calibration correction tables will become 
populated with values for SWH and for range. 


cc : 

David Hancock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 


To : Hayden Gordon 
From: Ron Brooks 

Date: August 10, 1994 (Revised August 16, 1994) 

Subject: Change in Summary 1 (I)GDR Data Base 

Software changes for the Summary (I)GDR data base program are requested, 
to accomplish the following: 

1. Assign identifiers "a" or "b" to the one-minute segments in 
the Summary (I)GDR data base. The segment would be an "a" 
if it were an ascending pass in the northern hemisphere (>5 
deg and <60 deg latitude) OR if it were a descending pass in 
the southern hemisphere (<-5 deg and >-60 deg latitude) ; in 
either event, the range-rate is positive. The segment would 
be a "b" if it were a descending pass in the northern 
hemisphere <>5 deg and <60 deg latitude) OR if it were an 
ascending pass in the southern hemisphere (<-5 deg and >-60 
deg latitude); in either event, the range-rate is negative. 

2. For Off-Nadir Angle in the Summary (I)GDR data base, store 
the me dian - 'rather than the mean value (0 < Angle ^ 0 • 2 ) . 


cc: 

David Hancock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 
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Changes in bold and strikeout as a result of instructions from the combined ADT/S WDT meeting. 


To : Hayden Gordon 
From: Ron Brooks 
Date: August 11, 1994 

Subject: Changing the Scale of the SSHResidualRMS Plot Within the (I)GDR 
Launch- to -Date Summary 


A software change is requested, to accomplish the following: 

Change the scale of the SSHResidualRMS plot within the (I)GDR 
Launch-to-Date Summary. The suggested scale change, based on the 
results of Dennis Lockwood ' s studies is : 

80-100 mm for the vertical scale 


Note: This increased vertical scale of 80-100 (previously 0-20) is 
required to accommodate the revised SSHResRMS computations, based on the 
Rapp method. 


cc: 

David Hancock 
George Havne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 



TOPEX InterOffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock 

From: Hayden Gordon 

Date: August 12, 1994 

Subject: Chan ge to (I)GDR Processing Module: SSHResRMS Plot Scale Changes 

Attached are two memos from Ron Brooks which address plot scale changes needed in the 
SSH_Residual_RMS plots with reference to the baselined (I)GDR processing module. Please consider the 
request, provide written comments if desired, and we will discuss it for possible implementation at the 
next ADT meeting. 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 


To : Hayden Gordon 
From: Ron Brooks 
Date: August 10, 1994 

Subject: Changing the Scale of the SSH Residual RMS Histogram within the 
(I)GDR Cycle Summary 


A software change is requested, to accomplish the following: 

Change the scale of the SSH Residual RMS histogram plot within the 
(I)GDR Cycle Summary. Suggested scale changes, based on the 
results of Dennis Lockwood's studies are: 

0-8 for the vertical scale 
0-300 for the horizontal scale 
Bin size of 5 


cc : 

David Hancock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 


To : Hayden Gordon 
From: Ron Brooks 
Date: August 11, 1994 

Subject: Changing the Scale of the SSHResidualRMS Plot Within the (I)GDR 
Launch-to-Date Summary 


A software change is requested, to accomplish the following: 

Change the scale of the SSHResidualRMS plot within the (I)GDR 
Launch-to-Date Summary. The suggested scale change, based on the 
results of Dennis Lockwood's studies is: 

80-100 mm for the vertical scale 


Note: This increased vertical scale of 80-100 (previously 0-20) is 
required to accommodate the revised SSHResRMS computations, based on the 
Rapp method. 


cc: 

David Hancock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 


TOPEX InterOfiice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock 

From: Hayden Gordon 

Date: August 12, 1994 

Subject: Change to (I)GDR Processing Module: Apply CAL Corrections 

Attached is a memo from Ron Brooks which addresses the application of calibration corrections to data 
retrieved from the (I)GDR database (and, hence, any derived products) with reference to the baselined 
(I)GDR processing module. Please consider the request, provide written comments if desired, and we will 
discuss it for possible implementation at the next ADT meeting. 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 




To : Hayden Gordon 
From : Ron Brooks 
Date: August 10, 1994 

Subject: Applying Calibration Corrections to (I)GDR Data 
Retrieval Products 

A software change is requested, to accomplish the following: 

Apply* as a part of routine processing, time-varying calibration 
corrections to standard retrieval products from the (I)GDR data 
base. AGC corrections would be added to sigma-naught. SWH 
corrections would be added to SWH. Height corrections would be 
subtracted from sea surface height. 

For example, there presently exists a table of AGC calibration 
corrections which is periodically updated. Some of these corrections 
have been already applied (by the TGS) to the altimeter measurements; 
others have not. We would wish to routinely apply these remaining 
corrections to the sigma-naught retrieval products from the (I)GDR data 
base. 

It is anticipated that similar calibration correction tables will become 
populated with values for SWH and for range. 


cc: 

David Hancock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 



TOPEX Interoffice Memo 


To: 

From: 

Date: 

Subject: 


Ron Brooks, Ron Forsythe, George Hayne, David Hancock 
Hayden Gordon 
August 12, 1994 

Change to (I)GDR Processing Module: Database Additions 


Attached is a memo from Ron Brooks which addresses an additional parameter to differentiate between 
+/- Range Rates, and a change in the statistical parameter calculated for Off-Nadir Angle, with reference 
to the QGDR database within the baselined (I)GDR processing module. If there are ANY other 
changes/additions to the (I)GDR database, please bring these to the attention of the ADT/SWDT at this 
time. Please consider the request, provide written comments if desired, and we will discuss it for possible 
implementation at the next ADT meeting. 


Thanks, 


CC: Jeff Lee, Dennis Lockwood, Carol Purdy 



To : Hayden Gordon 

From: Ron Brooks 

Date: August 10, 1994 

Subject: Change in (I)GDR Data Base 

Software changes for the (I)GDR data base program are requested, to 
accomplish the following: 

1. Assign identifiers "a" or “b* to the one-minute segments in 
the (I)GDR data base. The segment would be an "a" if it 
were an ascending pass in the northern hemisphere (>5 deg 
and <60 deg latitude) OR if it were a descending pass in the 
southern hemisphere (<-5 deg and >-60 deg latitude); in 
either event, the range-rate is positive. The segment would 
be a "b" if it were a descending pass in the northern 
hemisphere (>5 deg and <60 deg latitude) OR if it were an 
ascending pass in the southern hemisphere (<-5 deg and >-60 
deg latitude); in either event, the range-rate is negative. 

2. For Off-Nadir Angle in the (I)GDR data base, store the 
median rather than the mean value. 


David Heine ock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 



TOPEX LnterOITice Memo 

To: 

From: 

Date: 

Subject: 

Attached is a memo from Dennis Lockwood and Jeff Lee which addresses a small anomaly found in the 
(IXjDR Pass plots within the baselined (I)GDR software. Please consider the request, provide written 
comments if desired, and we will discuss it for possible implementation at the next ADT meeting. 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy (w/out attach.) 


Ron Brooks, Ron Forsythe, George Hayne, David Hancock 
Hayden Gordon 
September 9, 1994 

Change to (I)GDR Processing Module: Pass Plot Correction 




Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To: 

From: 

Date: 

Subject: 



e^f^ee" 


CSC/ Hayden Gordoij 
CSC /Dennis Lockwc 
September 2, 1994 

Suggested Correction to IGDR Plotting. 


In testing MGDR software, we have discovered a potential problem with the 
IGDR pass plotting EDL program, igdrpass. An assumption is made when 
determining grid values, that there will be no large data gaps. This assumption 
is proved invalid on certain passes when the TOPEX ALT crosses over South 
America and also when POSEIDON returns no data over land. The problem 
has been corrected in mgdrpass. We recommend that the same changed be 
made in igdrpass. Sample plots are attached. 
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TOPEX InterOfiice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

From: Hayden Gordon 

Date: September 9, 1994 

Subject: EA S/W Chg 18: SSHResRMS Plot Scale Changes 

Attached are two memos from Ron Brooks which address plot scale changes needed in the 
SSH_Residual_RMS plots with reference to the baselined (I)GDR processing module. The change, 
designated Engineering Assessment Software Change Request 18, has been completed. IDL programs 
Igdrdb.pro' & lgdrsum.pro’ were modified on 9/2/94; a sample of each plot produced by these programs 
is attached. 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 


To : Hayden Gordon 
From: Ron Brooks 
Date: August 10, 1994 

Subject: Changing the Scale of the SSH Residual RMS Histogram within the 
(I)GDR Cycle Summary 


A software change is requested, to accomplish the following: 

Change the scale of the SSH Residual RMS histogram plot within the 
(I)GDR Cycle Summary. Suggested scale changes, based on the 
results of Dennis Lockwood's studies are: 

0-8 for the vertical scale 
0-300 for the horizontal scale 
Bin size of 5 


cc : 

David Hancock 
George Hayne 
Ron Forsythe 
Denn is Loc kwo od 
Jeff Lee 


To : Hayden Gordon 
From : Ron Brooks 
Date: August 11, 1994 

Subject: Changing the Scale of the SSHResidualRMS Plot Within the (I)GDR 
Launch-to-Date Summary 


A software change is requested, to accomplish the following: 

Change the scale of the SSHResidualRMS plot within the (I)GDR 
Launch-to-Date Summary. The suggested scale change, based on the 
results of Dennis Lockwood's studies is: 

80-100 mm for the vertical scale 


Note: This increased vertical scale of 80-100 (previously 0-20) is 
required to accommodate the revised SSHResRMS computations, based on the 
Rapp method. 


cc: 

David Hancock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 


TOPEX InterOffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

F rom: Hayden Gordon 

Date: September 9, 1994 

Subject: EA S/W Cbg 16: Summary Database Additions 

Attached is a memo from Ron Brooks which addresses an additional parameter to differentiate between 
+/- Range Rates, and a change in the statistical parameter calculated for Off-Nadir Angle, with reference 
to the Summary (I)GDR database. This change, designated Engineering Assessment Software Change 
Request 16, has been completed. The database code was modified to process ’a’ & V according to the 
memo, the structure of the Summary Database changed to accommodate ONA-A & ONA-E, the 
Summary Database regenerated, the IGDR Summary Plot program modified, and a new Launch-to-Date 
plot made. The change was made 9/6/94, and the affected plot products are attached 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 


To : Hayden Gordon 
From: Ron Brooks 

Date: August 10, 1994 (Revised August 16, 1994) 

Subject: Change in Summary 1 (J)GDR Data Base 

Software changes for the Summary (I)GDR data base program are requested, 
to accomplish the following: 

1* A„ssign identifiers "a" or *b" to the one-minute segments in 
the Summary (I)GDR data base. The segment would be an "a* 
if it were an ascending pass in the northern hemisphere <>5 
deg and <60 deg latitude) OR if it were a descending pass in 
the southern hemisphere (<-5 deg and >-60 deg latitude) ; in 
either event, the range-rate is positive. The segment would 
be a "b* if it were a descending pass in the northern 
hemisphere (>5 deg and <60 deg latitude) OR if it were an 
ascending pass in the southern hemisphere (<-5 deg and >-60 
deg latitude); in either event, the range-rate is negative. 

2. For Off-Nadir Angle in the Summary (I)GDR data base, store 
the m ed ian rather -fr han. the mean value (0 < Angle <0.2). 


cc: 

David Hancock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 
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Changes in bold and strikeout as a result of instructions from the combined ADT/SWDT meeting. 


TOPEX Interoffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

From: Hayden Gordon 

Date: September 21, 1994 

Subject: EA S/W Chg 21: (I)GDR Pass Plot Correction 

Attached is a memo from Dennis Lockwood and Jeff Lee which addresses a small anomaly found in the 
(I)GDR Pass plots within the baselined (1)GDR software. This change, designated Engineering 
Assessment Software Change Request 21, has been completed. The change was implemented on 9/16/94, 
and will become effective beginning with Cycle 073, PasslOl data. Copies of the output products are 
attached. 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy (w/out attach.) 



TOPEX InterOffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock 

From: Hayden Gordon 

Date: September 21, 1994 

Subject: Change to (I)GDR Summary Database: 10 Editing & Scale Revisions 

Attached is a memo from Ron Brooks which addresses changes to the (I)GDR Summary Database and 
associated derived plots within the baselined (I)GDR software. Please consider the request, provide 
written comments if desired, and we will discuss it for possible implementation at the next ADT meeting. 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy (w/out attach.) 


To : Hayden Gordon 
From: Ron Brooks 
Date: September 20, 1994 

Subject: Changes to (I)GDR Summary Data Base and Associated Plots 

Changes to the (I)GDR Summary Data Base and associated plots are 
requested, as follows: 

1. Edit all parameters whenever: 

Off-Nadir Angle >0.12 deg or SigmaO_ku >16 dB. 

2. Use 1-min segments only when number of records >45. 

3. Delete the plot of "Cumulative Histogram of SSHBad09" . 

4. Add a plot of SigmaO_Ku (horizontal axis) vs. SigmaO_C 
(vertical axis) . Scale of horizontal axis would be 6- 
16, scale of vertical axis would be 10-20. 

5. Change horizontal scale of Histogram of SigmaO__Ku from 
4-20 to 6-16. 

6. Change horizontal scale of Histogram of SigmaO_C from 
8-24 to 10-20. 

7. On the scattergram plot of SigmaOKu vs. Off Nadir 
Angle, change the vertical scale from 5-25 to 5-20, and 
change the horizontal scale from 0.0-0. 4 to 0.0-0. 2. 

8. On the scattergram plot of SigmaOKu vs. SWHKu, change 
the vertical scale from 5-25 to 5-20. 

9. Add to the database summary the number of points edited 
by Off-Nadir Angle >0.12 deg and the total number of 
points edited by all three criteria listed in items 1 
and 2 above. 

10. Rerun all (I)GDR Cycle Summaries to date with new 
criteria (this may require a separate request?) 

cc : 

David Hancock 
George Hayne 
Ron Forsythe 
Jeff Lee 
Dennis Lockwood 
Carol Purdy 




Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To: CSC/Hayden Gordojo^- 

From: CSC/Dennis Ldckwood, CSC/Je^f tee 

Date: October 28, 1994 

Subject: GDR Cycles 1-8 absence. 


In response to a question raised by George Hayne regarding absence of GDR cycles 1-8, 
please review and file attached memo from JPL. Refer to Page 1, Paragraph 6. This 
states that the AltJBadl bit 7 is set. Under GDR processing requirements if any bits of 
the Alt_Badl word are set, the record is considered "bad." 


GDR Comments -- Cycles 4, 5, 6, 7, 8, 30 


93/09/01 


GDR Comments — Cycles 4, 5, 6, 7, 8, 30 


General 

1 . Cycle 30 continues the regular distribution of NASA GDRs. Cycles 4-8 com- 
plete the reprocessing the early mission data when the satellite attitude system was 
not calibrated (See below). Cycle 31 was entirely SSALT (CNES). Thus, the next 
NASA GDRs you will receive will be in mid-October when cycles 32 - 35 are 
completed per the original agreement between PO-DAAC and the Project for 
shipping sets of 3 cycles. 


2. The correct Software Interface Specification for reprocessed data, all data from 
cycle 23 onward, and all GDRs is 

"GDR Data", Project Document 633-751-23-004, JPL D-8594, Rev. £, 

March 1993. 


3. Data from cycles 1 through 8 should be used with great caution and conclu 
sions regarding changes between these cycles and later cycles should be re- 
viewed carefully. 


4. A leap second occurred June 30, 1993 at 181T23:59:60 during cycle 29 
pass 083. Note that time tags in seconds can not be differenced across this date. 
See the GDR Users Handbook for details. 


5. A complete draft of the revised GDR Users Handbook is planned for early 
September distribution. 


Technical 

1. For cycles 1 - 8 (to pass 189) Alt Badl bit 7 (si 022 Ranee correction) is always 
set (Tl. 

This is because the satellite attitude is not usable for computing the variable part of 
the center of gravity correction (sl038_CG_Corr, #91) ; the static CG correction 
and the part due to any attitude bias used to attempt to correct the altimeter pointing 
are included. Thus, it is not possible to use the Alt_Badl = Geo_Bad = 0 flag 
selection criteria. 

For flag usage, check section 3.3.7 of the new GDR Users Handbook. 


l 



GDR Comments - Cycles 4, 5, 6 , 7, 8 , 30 93/09/01 

2. The satcih e attitude control system was first calibrated on 
1992-343T21 42:44, cycle 8, pass 189. After this time, the pointing was much 
improved, hi CG correction is computed, and Alt_Badl bit 7 (sl022 Range correc- 
tion) becon^ usable. 

The attitude control system was further calibrated on 1992-353T19:46:12, 
cycle 9, pa s .88. The pointing was brought completely within specification on 
1992-357T 17:22:33, cycle 10, pass 035, when a new attitude bias was sent to the 
satellite. 

The off nadir angle is generally smaller for cycles 4-8 than 1 - 3. However, users 
are reminded that the data are cutoff at 0.45 deg as that is the limit to which the 
computation is valid. Thus, there are points with 0 for DR(SWH/Att) simply 
because the off nadir angle exceeded the limit. A second point regarding 
DR(SWH/Att) is that the value is less reliable for off nadir angles greater than 

0.3 deg. The actual additional error will depend on both attitude and SWH, but it 
will typically be 1 to 2 cm. 


3. In reviewing the data for cycles 1 - 3, it was observed that the histogram of the 
difference between Wet_Tropo_Rad and Wet_Tropo_FMO was different for values 
less than about -70 mm, i.e., (Wet_Tropo_Rad - Wet_Tropo_FMO) < -70, than 
cycle 28. This corresponds to the TMR path length correction being more than 
7 cm greater than the model value. The change is that in early cycles the histogram 
declines smoothly from the peak at zero difference to no counts at a difference of 
15 cm while in the later cycles the decline in counts shows a sharp break at about 
-70 mm. There is no apparent change in the histogram shape for positive 
differences or in the histogram of Wet_Tropo_Rad values. Review of the 
histograms of all cycles showed that there was essentially a step change in the type 
of histogram between cycles 16 and 17 (February 28, 1993). 

Data for cycles 5 and 30 are different from this pattern, but cycles 4, 6, 7, 8 con- 
tinue the trend noted previously. Investigation of this effect is continuing. 


Cvcle 4 

1 . The data begin with pass 044; SSALT was On before that time. There are 21 1 
passes of Alt data. 


2. An attitude bias to improve overall pointing of 
Roll = -.11 deg, Pitch = +.4 deg 
was introduced on pass 101, 1 992-300T 1 9:35 :36 . 
Most off nadir angles are less 0.24 deg. 


i 
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GDR Comments -■ Cycles 4, 5, 6, 7, 8, 30 


93/09/01 


Altimeter boresight calibrations v.eie performed for approximately 10 minutes 
starting at 

Pass 1992-doyThh:mm:ss 
005 297T00:32:00 

182 303T23 :33:00 . 


3. A histogram of sea surface height minus mean sea surface (without tidal 
corrections) will show an excess near + 12 cm of about 500 counts. This may be 
caused by a very sharp peak (about 5000 extra counts) in the Earth tide histogram at 
-12 cm. It is believed that the tidal models are correct and that this is simply a 
"numerical (or, astronomical) accident". 


Cycle 5 

1. SSALT was On for passes 219-244. There are 228 passes of Alt data. 


2. Off nadir angles are mostly less 0.35 deg. Recall that the pointing angle/seastate 
corrections become less reliable for angles greater than 0.3 deg. 

Altimeter boresight calibrations were performed for approximately 10 minutes 
starting at 

Pass 1992-doyThh:mm:ss 
106 310T22:09:00 . 


Cycle 6 

1 . SSALT was On for passes 19-45 and 220-244. There are 202 passes of Alt data. 


2. Off nadir angles are mostly less 0.35 deg; however, the attitude did exceed 
0.45 deg during this cycle. 

Altimeter boresight calibrations were performed for approximately 14 minutes 
starting at 

Pass 1992-doyThh:mm:ss 

030 3 1 7T20:53:00 (SSALT) 

208 324T1 9:38:00 

234 325T20:01:00 (SSALT) . 
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GDR Comments -- Cycles 4, 5, 6, 7, 8. 30 


93/09/01 


Cvcle 7 


1 . This cycle is all NASA Alt data. 


2. There are two peaks in the off nadir angle distribution: .09 and .28 deg. Some 
points exceed .45 deg. 


Cvcle 8 

1 . SSALT was On for passes 220-254. There are 218 passes of Alt data. 


2. Off nadir angles are mostly less 0.35 deg; however, the attitude did exceed 

0.45 deg during this cycle. 

As noted above the satellite attitude control system was calibrated on 
1992-343T21 :42:44, cycle 8, pass 189. After this time, the pointing was much 
improved, the CG correction is computed, and Alt_Badl bit 7 (si 022 Range correc- 
tion) becomes usable. 

The pitch bias was changed to +0.15 deg (from +0.4 deg) on pass 089, 1992- 
340TOO:06:24 . 

An altimeter boresight calibration was performed for approximately 26 minutes 
starting at 

Pass 1992-doyThh:mm:ss 

247 346T04: 13:00 (SSALT) . 


Cvcle 30 

1 . The NASA Alt was On throughout the cycle. 


2. Passes 33 - 34 and 195 - 196 had a relatively large number of data transmission 
errors. This may cause some gaps in TMR data to be flagged (a value will still be 
produced, but it will be an extrapolation from previous data). 
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TOPEX InterOffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

From: Hayden Gordon 

Date: October 31, 1994 

Subject: GDR Cycles 1-8, Clarification 

Attached please find a memo from Dennis Lockwood and Jeff Lee clarifying a question raised by George 
Hayne regarding the absence of Cycles 1 -8 in the processed GDR data. 

Please add this memo and its attachments to the package which was distributed on April 1, 1994, with the 
cover memo bearing the title, "Change Control Status for (I)GDR Processing Module". 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 


To: Hayden Gordon 

From: Ron Brooks 

Date: February 3, 1995 

Subject: TOPEX Software Modification 

I recommend a modification to the TOPEX change-controlled 
software, to change the vertical scales on the GDR Launch-to- 
Date Cycle Summary plots. The recommended new scales are shown 
in the Attachment. 

The selection of these particular scales is the result of an 
iterative study, in response to Work Requests 95/017 and 95/026. 

These new scales allow for more meaningful displays of the data. 


Attachment: Newly-Scaled Launch-to-Date Cycle Summary Plots 


cc : 

David Hancock 
George Hayne 
Ron Forsythe 
Dennis Lockwood 
Jeff Lee 
Carol Purdy 
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TOPEX Engineering Assessment S/W Change 


To: 

From: 

Date: 

Subject: 


Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 
Hayden Gordon 
March 15, 1995 
Request #95/046 

GDR Launch-to-Date Cycle Summary Plot Scale Change 


A Change Request was submitted by R. Brooks to modify the vertical scales on 
the GDR Launch-to-Date Cycle Summary plots in the baselined (I)GDR 
Processing Module. The change has been investigated under Study Requests 
#95/017 & #95/026. This Engineering Assessment Software Change, designated 
Request #95/046, has been completed. The change was implemented on 2/15/95, 
with revised components of the (I)GDR Processing Module. The SWDT 
completion memo, and sample plots, with new plot scales and labels, are 
attached. 

Thanks, 


CC: Jeff Lee, Dennis Lockwood, Carol Purdy (w/out attach.) 



To: CSC /Hayden Gordon 

From: CSC / Jeff Lee 

Date: February 15, 1994 

Subject: RE> Request 95/046 

Software Development 
Team 

TOPEX Project 
NASA GSFC/WFF 


In response to Request#95/ 046, changes have been made to the following 
components of the GDR processing system: 

igdrsum no version number Changed plot scales 

readigdrsum no version number Changed plot labels 

All changes are completed and new software is in place as of 02/15/95. Sample 
products are attached. 


TOPEX Engineering Assessment S/W Change 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

From: Hayden Gordon 

Date: September 29, 1995 

Subject Request #95/149 
Geo Bad Bits 


Attached is a memo from Ron Brooks which addresses a proposed change 
to the baselined IGDR Software. This Engineering Assessment Software 
Change, designated Request #95/149, has been completed. The change was 
implemented on 9/11/95, to coincide with the start of IGDR Cycle #109. 
Software changes were made to GDRDBAvg.f, and a new version 1.2 of 
‘doGDR.f was released on 9/11/95. A memo from Dennis Lockwood is 
attached showing the current record selection criteria. 

Thanks, 


C C : Jeff Lee, Dennis Lockwood, Carol Purdy (w/out attach.) 
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let Propulsion LaboraLOry Interoffice Memorandum 

3340-95-185 
December 21, 1995 


To: Distribution 

From: P. S. Callahan 

Subject: Change Requests for SDS GDR Upgrades 

.'Several changes arc needed in SDS io make changes requested by ihe SWT or to enhance GDR 
accuracy 

1. Provide new tide models (gl061). The SWT has derived numerous new tide models. After much 
evaluation the two selected are a model from the University of Texas (UT CSR 3.0) and the 
hydrodynamic model of LeProvost FES 95.2.1 . The UT model is based on altimeter data, while FES 95 
is mainly a hydrodynamic model but with some altimeter data assimilation. The last decimal of the FES 
designation indicates a change which was made after the October 1995 SWT to correct some small 
inconsistencies in the model. The UT model includes a loading tide computation. 

These models will also be used by PO-DAAC and AVISO for the merged GDRs. In order to simplify 
software maintenance, it is recommended that the current SDS algorithms be entirely replaced by the 
code which PO-DAAC' lias developed from the mode! providers. 



2. Correct Pole Tide (g 1 063). POD discovered a discrepancy in the pole tide on the GDR. The 
problem is that average values of the pole position must be subtracted from the current values obtained 
from the POD. The resulting error is up to 13 mm. The values to subtract arc 
x_pole_avg = 0.04-2 arc sec: y_polc_avg = 0.293 arc see. 


3. Provide new surface height fields (,gl065). Richard Rapp of Ohio State University has supplied 
new- geoicl and mean sea surface, files. They have twice the resolution of the current fields, so, 
particularly lor the MSS, a revised interpolator is needed to speed processing. The new fields 
incorporate TOPKX data and are consistent with the JGM3 gravity field used for POD. 

These models will also be used by PO-DAAC and AVISO lor the merged GDRs. In order io simplify 
software maintenance, it is recommended that the current SDS algorithms be entirely replaced bv the 
code which PO-DAAC has developed. 


4. Provide atmospheric-correctcd sigmaO (gl260) to F.M Bias computation (g!064) with revised 
sigmaO offset. The 1£MB is parameterized in terms of wind speed. Wind speed is obtained from the 
sigmaO value by table lookup The table is based on Gcosat values. Comparison of nearly two years of 
Gcosai and TOPEX sigmaOs indicates that the offset between the TOPEX GDR atmospheric corrected 
sigmaO and Geosat is -0.63 dB In order to use this offset and to provide correction Jor atmospheric 
clfect.s, ii is necessary that the atmospheric corrected sigmaO be passed to the EMB computation. 
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Research hy Mike Freilich of OSU indicates that the TOPEX atmospheric attenuation correction is fairly 
accurate (although the individual vapor and liquid components arc not as reliable). 


5. Revise EM Rias coefficients to values found from TOPEX data. Values are not yet available. We 
have fu K and C band data separately as requested by Dudley Chelton at the SWT meeting. The K band 
results are similar to those found before, but the C band values appear to be rather different from those 
currently in use. We arc continuing to test the fits. In order to provide final parameters, we will need to 
find a proper parametric representation of the non-parametric fits (which wc believe to be much more 
reliable) and to test the effect of the new coefficients on the ionosphere If the latter is significant, then 
the C band range bias will need to be adjusted also. 


6. Revise GDR flags {.g J 080) to be consistent with 13117 fine height Rags and 1 1061 tide Hags. The 
Hags from the above revised algorithms will need to be stored on the GDR. Sheets with the MCRs 
indicate the desired locations and a revised specification for g!080 is also provided. 


7. Add fine height flags to t31 17 and pass through to GDR. Attached to the MGR is a revised 
algorithm specification which indicates how to produce these flags. The flags indicate which part of the 
digital filter bank (DFB) the signal is in. This is important because leakages in the waveform appear to 
be fixed in the DFB and >o contribute differently to the measured range as the actual signal is shifted 
based on the operation of (he hardware. The effect of the leakages also varies w ith gate index. The fine 
height flags will allow users to apply a correction to the sea surface height based on the position of the 
signal in the DFB and the gate index. • 


Attachments: MCRs 


Distribution: T. Antc7.ak. A. Bartulis, J. R. Benada, R. W. Bcrwin, G. Faist. 1 .-L. Fu, S. Resell, 
D. Royer 
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JPL TOIPEX/POSEIDON 

MOS Change Request (MCR) 


MCR No: 


3. SUBSYSTEM: 

mse/sds 


5. TITLE OP change. SEvipu"t A~tiM.os pkeric- Ccv'fec'ted S i g nus 6 
t* EM Bios Algor iirlnn Cg !0&i/) 


4. DATE. 

95/ & Azl / 


6. FR No 

7. ECR No: 

8. Other. 


9. DESCRIPTION OF CHANGE. pit't sp K^ync - SlcjVuaD o\m 0}2,&O 

j to (LNB c^foortill^^ o Use S t'g \mciD o-ffset' ^Ve/a^/V<r ’to teeosair) 

! 0 4 -o.t.3 SB ° " 

j HARDWARE CHANGE REQUIRED? □ YES X NO 

SOFTWARE CHANGE REQUIRED? □ FLIGHT JS( GROUND □ NONE 


10 AFFECTED ELEMENTS _ _ , 

/ 

INSTITUTIONS AFFECTED: /j^C CNES/O GSFC □ DSN □ WFF 

SUBSYSTEMS AFFECTED: □ TCCS □ MPSSS □ NAVS X. SDS □ SPAS C 

TEAMS AFFECTED; □ FCT O MPST □ NAVT X SOT □ SPAT C 

DOCUMENTATION AFFECTED: SIS □ SRO SS0 □ USER’S GUIDE X OTHER &--7X H&- 

OTHER AFFECTED ELEMENTS: □ TESTBED □ CMDLIB VAX ENVIRONMENT: □ TEST 


0 WFF 


□ TCCS □ MPSSS 

□ FCT a MPST 


□ DSN 

□ NAVS 

□ NAVT 


□ SPAS 

□ SPAT 


□ SS 
O PVT 



n impact if not implemented: Xn accuNTafp £-H8 , ke«c £ 


sea SU iT-facc h^iqlA~t. 


: 2 . PRIORITY': 

X CAT l - NO WORKAROUND EXISTS 

□ CAT 2 - ARDUOUS WORKAROUND EXISTS 

□ CAT 2 - ACCEPTABLE WORKAROUND EXISTS 

□ CAT 4 - DESIRABLE 


COMMENTS: 



13. CONCURRENCE (Sign an 
INITIATING TEAM CHIEF; 


14. IMPLEMENTATION 
CM EnQineer: 



'S//2-. 


AFFECTED TEAM CHIEF: 

AFFECTED TEAM CHIEF; 

AFFECTED TEAM CHIEF: 


DESIRED OPERATIONAL DATE 
DATE; 


15. APPROVAL CRITERIA 
COMMENTS: 


RECOMMENDATION FOR APPROVAL 



YES 

NO 

N/A 

System Engineer 

□ 

□ 

□ 

SS Manager: 

□ 

CD 

O' 

TGS Manager; 

□ 

CD 

□ 

FOS Manager 

□ 

CD 

□ 


APPROVED 

□ 

Mission Manager: 
Date: 


DISAPPROVED 

□ 


Continued on next page Q Yes Q No 
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JPL 


TOPEX/POSEIDON 

MOS Change Request (MCR) 


MCR No' 


1 ORIGINATOR . 2. EXT. 3. SUBSYSTEM: 

P. 5. CcJkha* V-WJj MSE/5DS 


5. TITLE OF CHANGE. Q.J) hlcip ( (j /08o) 


4 DATE . . , 

hs/u 2/ / y 


6. FR No 


7. ECR No: 


8. Other: 


9 DESCRIPTION OF CHANGE: 

5 JC H-ihtUi- Sfee/'-P.'caf.'on **> w/ ^ ^ ^ 

■Q-2)R. ufcfpades lyluck add -f-fajs. 

hardware change required? o yes ja' NO 

SOFTWARE CHANGE REQUIRED? □ FLIGHT ^ GROUND □ NONE 


0 . AFFECTED ELEMENTS 

INSTITUTIONS AFFECTED: ^ CNES □ GSFC □ DSN ^jfeCwFF 

SUBSYSTEMS AFFECTED: □ TCCS □ MPSSS □ NAVS % SDS □ 

TEAMS AFFECTED: C3 FCT □ MPST □ NAVT SOT □ 

DOCUMENTATION AFFECTED: SIS □ SRD ^ SSD □ USER'S GUIDE □ OTHER _ 

OTHER AFFECTED ELEMENTS: □ TESTBED □ CMOLIB VAX ENVIRONMENT 


, Xirfo 

Jii CNES □ GSFC 


J~yrfo 

^jfeCwFF 

% SDS □ SPAS □ SS 

sot □ spat □ pyr 

DE □ OTHER tdav\d hcc}C 


□ TEST Q OPS 


M. IMPACT IF NOT IMPLEMENTED: X 14 Correct £r$)R. -flap. 


12 PRIORITY: 

CAT 1 - NO WORKAROUND E XlSTS 

□ CAT 2 - ARDUOUS WORKAROUND .EXISTS 

□ CAT 3 • ACCEPTABLE WORKAROUND EXISTS 

□ CAT 4 - DESIRABLE 


COMMENTS: 


-<s ojured. ~fz> r cycle 42 V GD& 


13. CONCURRENCE (Sign anc 
INITIATING TEAM CHIEF: 


14. IMPLEMENTATION 
CM Engineer. 


75// V/? 


AFFECTED TEAM CHIEF: 

AFFECTED TEAM CHIEF. 

AFFECTEO TEAM CHIEF: 


DESIRED OPERATIONAL DATE: 
DATE: ... 


15 APPROVAL CRITERIA 
COMMENTS: 

RECOMMENDATION FOR APPFIOVAL 



YES 

NO 

N/A 

System Engineer: 

□ 

□ 

□ 

SS Manager: 

□ 

□ 

□ 

TGS Manager 

□ 

□ 

□ 

FOS Manager 

□ 

□ 

□ 


APPROVED 

□ 

Mission Manager: 
Date. 


DISAPPROVED 

□ 


Continued on next page Q Yes □ 
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TOPCX Algorithm Specification - gl080 - Make GDK Mags Version F(>5 0 95/1 2/2 I 


AT .GQR 1 THM TI 1 XE: MAKE GDR FLAGS 

ASSOCIATED NU MBERS : gl 080 Version -^- 5 . 1 ! *F 6 . 0 * 

HKRl'l'AGE : New 

Note: Inserts arc indicated by * *. SDS names [for some] variables are given in 
parentheses. All insert marks from F 4 t 9 *5.0* have been removed, so only 
F4 t9 *5.0* -> F&tO *6.0* changes are marked. 

* 

FUNCTI ON: 

To combine or pack Hags created in earlier processing for output to the GDR. It is 
desired to make flags easily interpretable by GDR data users while providing maximum 
insight into the sensor states and data processing. 


COMPONENTS: None 


MATHEMATICAL STATEMENT : 

Numerous flags are produced throughout the processing of altimeter. TMR. and satellite data. It is 
desired to provide a concise and informative set of flags for users of GDR data. This algorithm takes 
in many Hags produced during Telemetry', Sensor, and Geophysical processing and combines them, 
usually bv "ORing", or packs the flags as single bits into bytes. Several bytes indicating the altimeter 
suite are copied from the telemetry. All flags are set during processing to the IGDR; there, is no plan to 
update these flags during processing from IGDR to GDR. 

The flagging conveniior for TOPEX/POSEIDON is 

0 = test was dons and data passed 

1 = data failed or test was not done (missing/invalid data, etc ). 

Thus, if a flag is set to zero, or if an entire byte of packed flags is zero, one can use the accompanying 
data with confidence thai it has been checked and is good. 

Some invalid data may also be indicated by "null values". Usually, the null value is the maximum 
negative number which will lit in the format, but it may he zero or other particular values placed in the 
data fields. The interpretation of null values, as well as the (lag hits packed into bytes, will be described 
in the GDR Users’ Handbook The packing of bits into GDR bytes is also described in i he GDR Data 
S1S-2. 633-751-23-004 
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I TOPEX Algorithm Specification - glOXO - Make GDR Flags Version F6-S.0 

DATA : 

Input : (Organised by Source algorithm number.) 

k,no_Bad(0-9) 

Source: g!047 Frequency: l/$ciencc fr ( 10 pt) 

Quantity Checked: Flag_no_iono_corr. Flag. iono_corr_lim(i). Flag_lono_fit(i) 
SigmaO_C Out of Limits 

Source: g 1 050 Frequency: 1 /science frame 

Quantity Checked: SigmaO_C 

SigmaO_K Out of Limits 

Source: g 1050 Frequency: 1 /science frame 
Quantity Checked: SigmaO_K 

PFLAG 

Source: g 1055 Frequency: 1 /science frame 
Quantity Checked: Pressure field quality from CNES. 

Ocean_Tide_Invaiid 

Source: gl061 Frequency: 1/science frame 

I Quantity Checked: Tide height 
| 4- 2 flags: UT CSR 3.0, FES 95.2 * 

Flag_EiVlB_lim 

Source: gl064 Frequency: 1 /science frame 

Quantity Checked: Coefficient of SWH limited 

Flag_EM.B_SWH_ori.ly 

Source: g 1 064 Frequency: 1 /science frame 

Quantity Checked: No good sigmaO so coefficent of SWH fixed 

FI ag_G DR_co mpr 

Source: g 1071 Frequency: I /science frame 

Quantity Checked: GDR compression changed from line to median 

Flag_g 1 07 1 _siopc 

Source: gl07 1 Frequency: 1 /science frame 

Quantity Checked: Slope of fit line less than limit 

SSH_Bad(0-9) (Flag_SSH_Bad_gl07 1 ) 

Source: g]071 Frequency: 1/scicnce frame 

Quantity Checked. SS..Hght_Hi_Rale(i) differs from fit or Sea Surf. light 

too much 


'{/I 00/ 

95/12/21 
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| . TOPEX AJgouthm Specification - g 1080 • Make GDR Plugs Version F6S.0 95/12/21 

GD R_Com pr_ R M S [$S_RMS in GDR Data SIS | 

Source: gl07l Frequency: I /science frame 

Quantity Cheeked RNiS about SSH compression lit. 

Tb_Qual lot each channel 18, 22.37 GH? 

Source: g 1 256 Frequency: 3/science frame 
Quantity Checked Available pts for interpolation 

Rain Flag 

Source: §1257 Frequency: l /science frame 

Quantity Checked. Liquid water content -(or opacity?) 

Ice Flag 

Source: §1280 Frequency: 1 /alt frame 

(MCR 357) This will be replaced in SDS 5.0 by 
Smoothed_V'Au„flag_K and Smoothed_VAlt_flag_C 
Source: t5 135 Frequency: J /science frame 

Quantity Checked: VAu_K7C not computed (too many bad waveforms) OR 

VAtt out of limits 


C.FLAG 

Source: si 022 Frequency: I /science frame 

Quantity Checked Sum of C Range correction flags 

K_FLAC 

Source: sl()22 Frequency: 1 /science frame 
Quantity Checked: Sum of K. Range correction flags 

f LG_RMG_C i fl;ti;_PA(C) ) 

Source: si 057 Frequency: 1 /science frame 

Quantity Checked: FLG_V_Att, FLG_V_SWH 

FLG_RJS : G._ K ( flag_PA(K) ) 

Source: si 037 Frequency: I /science frame 

Quantity Checked: FLG_V_Alt. FLG_ V_SWH 


FI. AG.CG 

Source: si 038 Frequency I /science frame 
Quantity Checked. Center of Gravity Input Flags 

FJ. G_AGC._C (Fk, £ _PA_AGC(C) ) 

Source: s 1045 Frequency: 1 /science frame 
Quantity Checked: FLG_V_Att, FLG. V _.SWH 

FLG.AGC K (Rag_PA_AGC(K) ) 

Source: s 1045 Frequency: 1 /science frame 
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Quantity Checked: FLC_V_Au. FLG_V_SWIJ 

FLC_SWH_C ( Flag_PA_S WM(C) ) 

Source: si 05 I Frequency: 1 /science frame 

Quantity Checked: FLCi_V_Alt, FLG_V_SWH 

FLG_SWH_K (riag_PA_SWH(K) ) 

Source: s 105 1 Frequency: 1 /science frame 

Quaniity Checked: FLG_V_Att, FLG_V_$WH 

TFT. AG 

Source: SDR fS DR/11068) Frequency: 1/aJt frame 

i 

| * t3 1 1 7 Fine Height Flags: Flag_Fine_Hl_K/C 

| Source: SDR (i3 . 17) Frequency: 2 (K, C)/a!t frame * 

FLGSMF; (Ali_ting_Prelim_Flags) 

Source: t4 109 (S.DR) Frequency: 1 /eng frame 
Quantity Checked: Preliminary engineering frame flags. 

FLGSMS (AU_Sci_Prclim_Flags) 

Source: SDR/t4 109 Frequency: 1 /eng frame 

Quantity Checked: Preliminary alt science frame flags 

Deep Water Flag 

Source: SDR/171 10 Frequency: 1/science frame 

Quantity Checked Location 

Surface Type Flag • Altimeter 

Source: SDR/t7 10 Frequency: 1 /science frame 

Quantity Checked: Location 

Surface T ype Flag • TMR 
Source: (SDR/tT 110) 

Interpolated by gl256 from l/TMR point to 1/scicnce frame 
Frequency: 1/sciencc frame 
Quantity Checked: Location 

Mode Bytes (2) 

Source: SDR Frequency: 2/alt frame 
Gate Index Bvtc 

Source: SDR Frequency: 1/alt frame 

Limit Byte 

Source: SDR Frequency: 1/alt frame 
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Alt_Operate 

Source: SDR (t3 1 07) Frequency: I /ah frame 

CON 

Source SDR (t3 1 17) Frequency: 1 /ait frame 

KON 

Source. SDR (t3l 17) Frequency: 1 /all frame 

TMR21_Op_Flag 
Source: SDR (14308) 

Interpolated in g 1256 from 1/TMR frame to 1/scicnce frame 


Output : 

Alc_Bad(0-7) 


Ait_Bud2(0-7) 

Gco_Bad(0-7) 


Jnslr_State(0-7) 

fono_Bad(0-9. 11-12. 4. 13-14 *) 
SSI l_Bad(0-9, 11-12, a 14-15 *) 
Mode Bytes 
PFLAC 

Gale Index Byte 


internal Variables : 

None 


Auxiliary Data : 

Allowed number of bad high rate sea surface heights, 
SS H_Bad_ Allowed = 2 
Allowed number of bad ionosphere points, 
Iono_Bad_ Allowed. = 4 
Threshold for GDR compression RMS 
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GDR_RMS_ Allowed = 150 mm 


PROCESSING 

1. Set 1 nsti _S laic , Geo_Bad, Alt_Badl. Ali_Bad2 10 all ones. This is consistent with the flagging 
convention as the flags arc reset to 0 only if the checked flags indicate good data (0). SDS 4.0 docs 
NOT do this. Flac bvtes are initially sci to 0 and bits arc nirned On (1J if input flags indicate (1 or 
TRUE!. 


2. Set SSH_Bac!(0-9, ! 1-12) and count number of bad points to set Alt_Badl(l). 

Flags 0-9 jndicaie if individual 10/framc sea surface height points deviate by more than an 
allowed amount a$ described in g 1071 -GDR Data Compression. 

SDS Code: 

C Set SSH_Bad: sea surface heights and EM Bias Hags. 

SSH_Bad = 0 
Number J3S I l_Bad == 0 
DO FOR 1=1,10 

IF (FLAG_SSH_Ead_gl071(Ij) THEN 
SSH_Bad = 10R(SSH_Bad,B fTNUM(i-l)) 

Numbcr_SSIIJBad = Numbcr_SSil_Bad + 1 
END1F 
ENDFOR 

Two additional bits of $SH_Bad are used for flags regarding the EM Bias. 

IF (Flag_EMB_lim = 0) SET SSIl_Bad(l 1) = 0 

IF (Flag_EM_SWH_only = 0) Sot SSH_Bad(12) = 0 

NOT done, SSll.Bad = 0 to start: Set spare bits of SSH_Bad to 0. 

A Two additional bits of SSll_Bad are used for flags from the FES 95.2 tide algorithm: 

Set bits- 14- 15 = 

0 (00) If 4 pis were used in the interpolation 

1 (0 1 ) If 3 pts were used in the interpolation 

2(10) ff 2 pts were used in the interpolation (bad/quesiionable) 

3(11) If less than 2 pts were used in the interpolation OR other bad conditions occurred. * 

3. Set Iono_Bad(0-9, 11-12) 

Flags 0-9 indicate if individual 10/liame range points were not corrected for ionosphere or had 
an out of limits ionospheric correction. These conditions arc checked in glt)47-Make Combined 
Height llonol Flags based on input from g 1043-Make Combined Height and g 1073-Compress 
Ionosphere. 

SDS Code 

C Set Iono_Bad: ionosphere correction and telemetry flags. 
lono_Bad = 0 
Number_Jono_Bad = 0 
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DO FOR 1=1.10 
IF (lo«o_Bad_g 1047(1)) THEN 

lono.Bad " = JOR(Iono_Bad.BITNUM(I-l )) 

Number ,.lono_Bad = Number_Iono__Bad + 1 
ENDIF 
HNDFOR 

Two additional bus of iono_Rad arc used for flags regarding the original telemetry from (4109: 

SDS Code: 

TF (Alt_Eng_Prclim_Flags) iono_Bad = ]OR(Iono_Bad,BlTl 1) 

LF (A.lt_Sci..Prelim_Flags) Iono_Bad = lOR(Iono_Bad.BITJ2) 

NOT done, lono Bad = 0 to start: Set spare bits of lono_Bad to 0. 

a Two additional bits of lono_Bad are used for Fine Height Flags from t3 1 1 7 ; 
lono_Bad(13) = SDR Flag_Fine_Ht_K 

lono_Bad(l4) = SDR FIag_Firte_Ht_C ~ 

4. Set lnsu_State(0-7) 

The normal state is ail 0 indicating C band ON at 320 MHz, K band ON (and, lienee, primary), 
altimeter side A operating. FRU side A operating. TMR 2 1 GH7. side A ON. TMR 2 1 GHz side B 
OFF 

As noted above, in SDS 4. 1 lnstr_State is set to 0 and bits arc set to 1 if Bags indicate bad/off. 
This pan of the specification was not changed. 

Insir_Statc(0) : TF (CON = "OI4") lnstr_State(0) = 0 
Instr_State(l) : IF (CON = "320") Lnstr_State(l) = 0 
lnsu_Statc(2) : If (KON = "ON") lnstr„State(2) = 0 
lnstr_Staie(3) : IF (Alt_Opcrate = "A") Instr_State(3) = 0 
Instr. Statc(4) : TF (Limit_Bvie = 0) lnstr_Statc(4) = 0 
lnsir_.St;ite(5) : JF (TMR2 I A_Op = ‘'ON") instr_Statc(5) -• 0 
lnstr_State(.6) : If (TMR21B_Op = "OFF") Instr_Statc(6) = 0 
Instr J$iate(7) : IF (FLAG_CG = 0) Jnsir_Statc(7) = 0 

5. Set Geo__JBad(0-7; 

This set of Bags indicates that land flags were set for the altimeter or TMR, or if other 
geophysical conditions were not nominal. 

As noted above, in SDS 4. 1 Gco_Bad is set to 0 and bits are set to 1 if flags indicate bad/off. 
This part of the specification was not changed. 

Geo_Bad(0) : TF (Deep Water flag indicates "DEEP") Gco_Bad(0) = 0 
Geo_Bad( I ) : IF (Alt Surface Type flag indicates OCEAJ4) Geo_Bad( l ) =0 
Geo. Bad(2) : IF ( (TMR Surface Type flag indicates OCEAN) Geo_8ad(2) = 0 
Gco_Bad(3) : IF ( (Rain/Excess liquid Rag is NOT Set) Geo_Bad(3) =• 0 
C.Teo_Bad(4) : IF (Ocean_Tide_Invalid (lag ~ for UT CSR 3.0 tide a is NOT Set) 

Gco_Bad(4) = 0 
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The following has been changed lo be consistent with i* 1 256 Version 2.1, 93/03/08 g 1 256 output 
values of Tb_Qual flags are "Good" (0), "Fair" (1), ’’Poor’ (2), Bad (3). 

Gco_Bad(5) : Set bits 5 and 6 based on Tb_Qual flag -• 

Geo_Bad(6) : IF (all channels Tb_Qual = "Good") bits(5,6) = OU 

IF (1 or more channels of Th_QuaJ = "Fain") 

IP (1 or more channels Th_Qual = "Poor" 
bits(5,6) = 10 

IF ( 1 or more channels Th_Qual = "Bad") bits(5,6) = 1 1 

Gco_Bad(7) : IF (gl280_lcc Flagis NOT Set) Gco_Bad(7) = 0 
Note that this maintains the spec convention of unsetting flags. 

6. Set AU_Bad 1(0-7) 

Tlus set of flags indicates problems were detected with the altimeter sensor corrections, the 
ionosphere, or the compressed sea surface height output If this byte is all zero, it is likely that 
AJt_Bad2 will also be all zeros. 

As noted above, in SDS 4. 1 Alt_Badl is set to 0 and hits are set to 1 if Hags indicate bad/off. 
This pan of the specification was not changed. 

Alt„Bad 1(0) : IF (Flag_ODR_Compr = 0) Alt_Bad 1 (0) = 0 

Alt_Badl(l) : IF ( Surn(SSF!_Bad(0-9)i .L.E. S\SH_Bad_Allowed ) Alt_B;idl(l) = 0 
Alt_Badl(2) : FF ( (smoothed VAtt fla g K = 0) .AND. 

(srnoolhed_VAtt_flag_C = 0) ) Alt_Budl(2) = 0 
Alt_Bad 1(3) : IF (TFLAG = 0 (NOT set)) All_Badl(3) = 0 
Alt_Badl(4) : IF (Flag_s 1 07 l_slope = 0) Alt_Badl(4) = 0 
Alt_Badl(5) : IF (RMS GDR Compression .LT. GDR _RMS_Allowed) 

Alt_Badl(5) - 0 

Alt_Badl(6) : IF (Sum(Jono_Bad(0-9) XE. Iono_Bad_AUowed) 

Ali_Badl(6) = 0 

(That is, for lono_Bad_Allow'ed = 4, six or more good points gives a good ionosphere, 5 or 
less is bail.) 

Alt J3.ad 1(7) : JT ( (K_Flag = 0) AND (C_Flag = 0) ) Ait_Bad 1(7) = 0 

7. Set Ak._Bad2(0-7) 

Tins set of flags indicates if any of the pointing angle/sea state corrections were 
invalid, or sigmaO was out of limits. 

As noted above, in SDS 4.1 Alt_Bad2 is set to 0 and bits arc set to I if f lags 
indicate bad/off. This pan of- the specification was not changed. 

The conditions which set the flags in each of the pointing anglc/scastate correction algorithms 
are the. same. Thus, the flags in Ali_Bad2(l-4) arc redundant. 

Alt_Bad2(0) . Sparc 

Alt_Bad2(l ) : I - (FLC_RNG_K = 0) All_Bad2t I) = l) 

Alt_Bad2(2) : IF (FI.G_RNG_C = 0) Alt. B;td2(2)= U 
Alt _Bad2(3) : JF (FI..G. SWH_C =■ 0) Alt_Bad2(3) = 0 
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Alt_Bad2(4) : IF (FLC_SWH_K = 0) Alt_Bad2(4) = 0 
Alt_Bad2(5) : IF ( (FLG_ AGC_C = 0) .AND. (SigmaO_C_OOL = 0) ) 

Ali_Bad2(5) = 0 

A!i B.kI 2(61 : IF ! (FLC_AG0_K = 0) AND (Sigma()_K. OOL = 0) J 
A It. Bad 2(6) = 0 

Alt_Bad2(7) : Sparc 


H. Copy GDR 

(1) PFLAG 

Source, g 1055 Frequency: 1 /ait frame 

(2) Mode Bytes (2) 

Source: SDR Frequency: 2/alt frame 

(3) Gate Index Byte 

Source SDR Frequency: 1/aJt frame 


9. Icc Flag Processing 

Ice flag processing is done in algorithm g!280, and its Hag passed into gi080 for insertion in C«eo_Bad. 


COM M i -NTS: 

The final coordination of flag consistency and names between algorithms probably will not be complete 
until soli ware is complete, but every attempt has been made here to provide, as much consistency as 
possible 


REFERENCES : 

I IGDR/GDR Data SIS-2, Project Document 633-751-23-004 
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TOPEX/POSE1DON 

MOS Change Request (MCR) 


MCR No: 


3. SUBSYSTEM: , 

mse/sds 


6. FR No 



s . t,tle of change- Add Fiae ^ Flap (tun) 


9 DESCRIPTION OF CHANGE: , , . _ . • t , r / 

Sec aifach-cd . _2I w qlgenth m ~E3lO dc'tev' ma/ *< f Tine height S-la.gS . 

P lace tlcjs SIR Qrtd pass -to 6-M. £ 

haroware change REOUIRED? o yes ]3( NO 

SOFTWARE CHANGE REQUIRED? □ FLIGHT GROUND O NGNE 


10. affected elements 

INSTITUTIONS AFFECTED. □ CNES □ GSFC 


□ DSN 


TEAMS AFFECTED 


SUBSYSTEMS AFFECTED: □ TCCS □ MPSSS □ NAVS % SOS □ SPAS □ SS 

TEAMS AFFECTED □ FCT Q MPST □ NAVT jS^ SOT O SPAT □ PVT 

DOCUMENTATION AFFECTED: $ SIS □ SRD J2( SSD □ USER’S GUIDE □ OTHER fra*d booK 

OTHER AFFECTED ELEMENTS: □ TESTBED □ CMDLIB VAX ENVIRONMENT: □ TEST OOPS 


n impact if not implemented: fj a j (oLO ~6o correct errors CCLUSeJ 

by u) o. u t %-o y > v\ IcqKo.^^s. 


12. PRIORITY 

jgr CAT 1 - NO WORKAROUND EXISTS 

□ CAT 2 - AROUOUS WORKAROUNO EXISTS 

O CAT 3 • ACCEPTABLE WORKAROUND EXISTS 

□ CAT a - DESIRABLE 



13. CONCURRENCE (Sign ai 
INITIATING TEAM CHIEF: j 


14 IMPLEMENTATION 



15 // - 2/7 


CM Engineer: 


COMMENTS: 


'ujrcd -fair cycjc /3-V 


AFFECTED TEAM CHIEF 
AFFECTED TEAM CHIEF 
AFFECTED TEAM CHIEF 


DESIRED OPERATIONAL DATE: 
DATE: 


j 1 5. APPROVAL CRITERIA 
COMMENTS 


RECOMMENDATION FOR APPROVAL 
YES NO N/A 
System Engineer □ □ □ 

SS Manager: □ □ O 

TGS Manager □ □ □ 

FOS Manager □ □ O 


APPROVED 

□ 

Mission Manager: 
Date: 


DISAPPROVED 


Continued on next page.Q D No 
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MCR for Algorithm 13117 


This MCR consists of the followin': related pans. 

1 Change algorithm (3 1 P as indicated in the attached specification from WFF Change bars show the 
actual changes The change is to add K and C band flags for the Fine height word which determines 
where the signal is placed in the digital filter bank (DFB) This Hag can later be used to derive a 
correction to the uhimctei tracker value 

2 Store the two fine height Hags on the SDR in 

K band - AUimcter_Siatc bit 5 
C band -- Altimeter .State bit 6 

3. Read the fine height flags into the IGDR processing and pass them to algorithm g 1 280 (Make GDR 
Flags). Store the flags on the (I)GDR in 
K band -• Iono_Bad bu 13 
C band — lono_Bad bit 14 

4 Provide documentation to SWT on above changes. Change SDR SIS. (l)C.DR $1S. GDR Users 
I iandhook 



CSC /Ron Brooks ^ 

CSC/Dermis Lockv^ood, g^C/Jeff Lee 
March 14, 1996 

Request#96/010 
GDR s/w change study 


In response to Request Number 96/010, this memo will describe the necessary changes 
to the controlled software recommended by the SWDT. 

1 . Changes from JPL: 

Two additional bits of SSH_Bad, bits 14 & 15. 

Flags from Tide algorithm 

Two additional bits of Iono_Bad, bits 13 & 14. 

Iono_Bad(13) = Hag_Fine_Ht_K 
Iono_Bad(14) = Rag_Fine_Ht_C 

2. Software changes: 

Program GDRDBAvgi: The SSH_Bad is used on bits 0 thru 9 arid U 12. It will 

increment £Qunters where flags are non-zero’. At this time bits 14 & 15 are not 
used. (No action to be taken on this change) 

Program GDRDBAvg-f: The Iono_Bad is not used. It will have to be put in so that a 
counter can be incremented. The proposed method of capturing the Fine_Height 
Flag will be to check for Non-Zero and if that is true a counter for NumFineHtKu 
and NumFineHtC will be incremented. 

3. GDR Database changes 

In addition to the counter, two new output fields will have to be created which will 
be placed into the GDR database. 

This will have to be changed because the current database does not have the two 
fields for fine_height_flags. This will cause an enlargement of two fields for each 
record. 

4. GDR IDL changes: 

Since the GDR Database format will be changed the IDL programs that read and 
use the GDR Database will have to changed. 



IDL Programs: 
readigdrdb.pro 
readigdrsum.pro 
readigdr.pro 
readigdravg.pro 
HAS related *.pro 

Format & Logic attachments: 

The format of the GDR Database is attached with the proposed field additions. 

Also attached is the GDRDBAVG logic for incrementing the counters for the two 



Read Record from 1GDR 



Current Logic Criteria 












Proposed Logic Criteria 















Name 


TEpochSec 


ATB 


Cycle 


Pass 


RecCount 


PRGatelndx 


SCGatelndx 


Latitude 




SWHAttK 


SWHAttC 


SWHK 


NetAGCCorrK 


SSHgt 


OffNadir 


SSHres 


IonoCorr 


EMBiasCorrK 


EMBiasCorrC 


NetRngCorrK 


IonoCorrRMS 


SSHresRMS 


NumGeoBad 


NumAltBadl 


NumAltBad21 


NumAltBad22 


NumSSHBad09 


NumSSHBadl2 


NumFramesDel 


Units 

Format 

sec 

fl6.3 i 

date 

al7 

# 

a3 

# 

a3 

# 

f4.1 

# 

f3.1 

# 

£3.1 

deg 

f6.2 

deg 

f6.2 

m 

f7.2 

m 

(7.2 

m 

f4.1 

db 

f6.2 

m 

{7.2 

deg 

{4.2 

irv . 

{8.2 

m 

{7.2 

m 

{7.2 

m 

{7.2 

db 

{5.2 

db 

f 5.2 

m 

€7.2 

m 

{7.2 

db 

( 4.2 

m m 

( 6.2 

m m 

( 6.2 

# 

i3 

# 

i3 

# 

i3 

# 

i3 

# 

i3 

# 

i3 

IB 

i3 

a 

i3 


Description 



Pass = 3372.885 seconds 


Nbr frames used in 60 sec av 




Height of sea surface above 
ellipsoid 


= SSHgt - OceanTide - SolidTide 
PoleTide - BaroCorr - MeanSSH 




Linear fit to SSHres 


Count nbr All bits Geo_Bad 


Count nbr All bits Alt_Badl 


Count nbr ibits(Alt_Bad2 / l,l) 


Count nbr ibits(AU_Bad2,2 / l) 


Count nbr ibits(SSH_Bad,0,9) 


Count nbr ibits(SSH_Bad,H,2) 


Count nbr ibits(Alt_Badl,3,l) 


Count nbr Frames Deleted 


Current nataK»c« r x 



































































































































Converted to 2000 Epoch 


UTC Time 


Cycle = 9.92 days 


Pass = 3372.885 seconds 


Nbr frames used in 60 sec av 



Height of sea surface above 
ellipsoid 


= SSHgt - OceanTide - SolidTide 
PoleTide - BaroCorr - MeanSSH 



Linear fit to SSHres 


Coimt 


Count 


Count 


Count 


Count 


Count 


Count 


Coimt 


Count 


Count 


Proposed Database Format 


nbr All bits Geo_Bad 


nbr All bits AltBadl 


nbr ibits(Alt_Bad2,l/l) 


nbr ibits(Alt_Bad2,2,l) 


nbr ibits(SSH_Bad,0,9) 


nbr ibits(SSH_Bad,ll,2) 


nbr ibitsCAlt.BadU,!) 


nbr Frames Deleted 


nbr ibits(Iono_Bad,13,l) 


nbr ibits(Iono_Bad,14,l) 













































































































































Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To: 

From: 

Date: 

Subject: 


CSC /Ron Brooks 
CSC /Dennis Lockwo' 
March 29, 1996 




, CSC//jerfLee 


Addendum to Request#96/010 
GDR s/w change study 


In response to Request # 96/010 and David Hancock mail 3/15/96, TOPEX GDR 

Changes. This memo will describe the necessary changes to the controlled software 
recommended by the SWDT. 

1. Changes from JPL: 

Two additional bits of SSH_Bad, bits 14 & 15. 

Hags from Tide algorithm 

Two additional bits of Iono_Bad, bits 13 & 14. 

Iono_Bad(13) = Hag_Fine_Ht_K 
Iono_Bad(14) = Flag_Fine_Ht_C 

Redefining of GEO_Bad, bit 4. 

Hag from Ocean Tide algorithm 


2. Software changes: 

Program GDRDBAvg.f: The SSH_Bad is used on bits 0 thru 9 and 11 thru 12. It will 
increment counters where flags are non-zero. Bits 14 & 15 are checked for value 
greater than 1. If so then frame will be deleted. 

Program GDRDBAvg.f: The Iono_Bad is not used. It will have to be put in so that a 
counter can be incremented. The proposed method of capturing the Fine_Height 
Hag will be to check for Non-Zero and if that is true a counter for NumFineHtKu 
and NumFineHtC will be incremented. 

Program GDRDBAvg.f: The GEO_Bad is used on all bits. It will increment 
counters where flags are non-zero, and the frame will be deleted if non-zero. (No 
action to be taken on this change) 

3. GDR Database changes 

In addition to the counter, two new output fields will have to be created which will 
be placed into the GDR database. 


This will have to be changed because the current database does not have the two 
fields for fine_height_flags. This will cause an enlargement of two fields for each 
record. 

4. GDR IDL changes: 

Since the GDR Database format will be changed the IDL programs that read and 
lose the GDR Database will have to changed. 

IDL Programs: 
readigdrdb.pro 
readigdrsum.pro 
readigdr.pro 
readigdravg.pro 
HAS related *.pro 

5. Format & Logic attachments: 

The format of the GDR Database is attached with the proposed field additions. 
Also attached is the GDRDBAVG logic for incrementing the counters for the two 
fields. 

6. Source Code attachments: 



Current Logic Criteria 
















Proposed Logic Criteria 











Field | Name 


TEpochSec 




Cycle 


Pass 


RecCount 


PRGatelndx 


SCGatelndx 


8 Latitude 


Longitude 


10 SWHAttK 


11 SWHAttC 


12 SWHK 


13 NetAGCCorrK 


14 SSHgt 


15 OffNadir 


16 SSHres 


IonoCorr 


EMBiasCorrK 


EMBiasCorrC 


SigmaOK 


AtmosSigmaO 


IonoCorrRMS 


SSHres RMS 


NumGeoBad 


NumAltBadl 


NumAltBad21 


Num AltBad22 


NumSSHBad09 


NumSSHBadl2 


NumTPlags 


NumFramesDel 


Units 

Formal 

sec 

fl6.3 i 

date 

al7 

# 

a3 ' 

# 

a3 

•4 
• TT 

f4.1 

# 

f3.1 

# 

£3.1 

\wm 

f6.2 

deg 

f6.2 

m 

f7.2 

m 

f7.2 

m 

f4.1 

db 

f6.2 

m 

{7.2 


{4.2 

m 

f8.2 

m 

{7.2 

m 

{7.2 

m 

{7.2 

db 

{5.2 

db 

{5.2 


{7.2 


{7.2 

db 

{4.2 

m m 

{6.2 

m m 

{6.2 

# 

i3 

a 

i3 

M 

tt 

i3 

# 

i3 

# 

i3 

# 

i3 


i3 

a 

i3 




Height of sea surface above 
ellipsoid 


= SSHgt - OceanTide - SolidTide 
PoleTide - BaroCorr - MeanSSH 





Linear fit to SSHres 


Count nbr All bits Geo_Bad 


Count nbr All bits AltJBadl 


Count nbr ibits(Alt_Bad2,l,l) 


Count nbr ibits(All_Bad2,2,l) 


Count nbr ibits(SSH_Bad,0,9) 


Count nbr ibits(SSH_Bad,ll,2) 


Count nbr ibits(Alt_Badl,3/l) 


Count nbr Frames Deleted 



























































































































Converted to 2000 Epoch 


UTC Time 


Cycle = 9.92 days 


Pass = 3372.885 seconds 


Nbr frames used in 60 sec av 



Height of sea surface above 
ellipsoid 


= SSHgt - OceanTide - SolidTide 
PoleTide - BaroCorr - MeanSSH 



N umFineHtCFlg 


Linear fit to SSFIres 


Count nbr All bits Geo_Bad 


Count nbr All bits Alt_Badl 


Count nbr ibits(Alt_Bad2,l,l) 


Count nbr ibits(Alt_Bad2,2,l) 


Count nbr ibits (SSH_B a d,0,9 ) 


Count nbr ibits(SSH_Bad,ll,2) 


Count nbr ibits(Alt_Badl^3 r l) 


Coimt nbr Frames Deleted 


Cbunt-'nbr ibits(Iono_Bad,13,l ) 


Count-nbr ibits(Iono_Bad,14,l) 


Proposed Database Format 
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Check for Useable Data 

if (ibits (ALLGeoBad, 0, 1) .ne. 0) then 
NumFr ame s De 1 = NumFramesDel + 1 
return 
endif 
C 

if (ibits (ALLAltBadl, 3 , 1) .ne. 0) then 
NumFramesDel = NumFr ame s Del + 1 
NumTFlags = NumTFlags + 1 
return 
endif 
C 

if (ALLAltBadl .ne. 0) NumAltBadl = NumAltBadl + 1 
if (ibits (ALLAltBad2, 1, 1) .ne. 0) NumAltBad21 = NumAltBad21 + 1 
if (ibits (ALLAltBad2, 2,1) .ne. 0) NumAltBad22 = NumAltBad22 + 1 
if (ALLGeoBad .ne. 0) NumGeoBad = NumGeoBad + 1 
do 40 i = 0,9 

if (ibits (ALLSSHBac, i, 1) .ne. 0) NumSSHBad09 = NumSSH3ad09 + 1 
40 continue 

do 45 i = 11,12 

if (ibits (ALLSSHBad,i,l) .ne. 0) NumSSKBadl2 s NumSSHBadl2 + 1 
45 continue 

C 

if ((ALLAltBadl .ne. 0) .or. (ALLAltBad2 .ne. 0)) then 
NumFramesDel = NumFramesDel + 1 
return 
endif 
C 

if (ALLGeoBad .ne. 0) then 

NumFramesDel = NumFramesDel + 1 
return 
endif 
C 
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Check for Useable Data 

if (ibits (ALLGeoBad, 0, 1) .ne. 0) then 
NumFramesDel = NumFramesDel + 1 
return 
endif 

if ( ibits (ALLAltBadl ,3,1) .ne. 0) then 
NumFramesDel = NumFramesDel + 1 
NumTFlags = NumTFlags + 1 
return 
endif 

if (ALLAltBadl .ne. 0) NumAltBadl = NumAltBadl + 1 
if (ibits (ALLAltBad2, 1,1) .ne. 0) NumAltBad21 = NumAltBad21 + 1 
if (ibits <ALLAltBad2, 2,1) .ne. 0) NumAltBad22 = NumAltBad22 + 1 
if (ALLGeoBad .ne. 0) NumGeoBad = NumGeoBad + 1 
do 40 i = 0,9 

if (ibits (ALLSSHBad, i, 1) .ne. 0) NumSSHBad09 = NumSSHBad09 + 1 
I continue 

do 45 i s 11,12 

if (ibits (ALLSSKBad, i, 1) .ne. 0) NumSSHBadl2 = NumSSK3adl2 + 1 
» continue 

if (ibits (ALLSSHBad, 14,2) .gt. 1) then 
NumFramesDel = NumFramesDel + 1 
return 
endif 

if ((ALLAltEadl .ne. 0) .or. ( ALLAltBad2 .ne. 0)) then 
NumFramesDel = NumFramesDel + 1 
return 
endif 

if (ALLGeoBad .ne. 0) then 

NumFramesDel = NumFramesDel + 1 
return 
endif 


if (ibits (ALLIonoB^d, 13, ll^sne. 0) Ni 
if (ibits^^IonoBa^^, 1) .rie^^O) Ni 


ineHfe^Flg = NumFineHtKFlg + 1 
■ineHtCFig^ = NumFih^HtCFlg + 1 




Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To: 

From: 

Date: 

Subject: 


CSC /Ron Brooks^ 
CSC/DenS^sLockwood, CSOJeff Lee 
September 5, 1996 
Change Request 96/146 


In response to Change Request 96/146, modify the (I)GDR database by the addition of 
two Fine Height Flags, and the associated programs. Modify the method of 
computation of SSHres. Modify the logic criteria for the selection of data to the 
database. Flow chart is attached of the new selection criteria and Database format. 


Software change: GDRDBAvgi (logic,format) 

GDRAvgi (logic,format) 

IGDREUConv.f (computation) 
readigdr.pro (format) 
readigdravg.pro (format) 

Data file change: GDR Database format(2 additional fields) 

Version: 1.3, 08/26/96 doGDRi 

Effective date: 08/26/96, beginning of IGDR cycle 144 

beginning of GDR cycle 133 



I 

I 


Effective 8/26/96 







1 

ISSSS9B1 

sec 

f!6.3 

2 

ATB 

date 

al7 

3 

Cycle 

# 

a3 

4 

Pass 

# 

a3 

5 

RecCount 

# 

f4.1 

6 

PRGatelndx 

# 

f3.1 

7 

SCGatelndx 

# 

£3.1 

8 

Latitude 

deg 

f6.2 

9 


IES9 

f6.2 

10 

SWHAttK 

m 

f7.2 

11 

SWHAttC 

m 

f7.2 

12 

SWHK 

m 

f4.1 

13 

NetAGCCorrK 

db 

f6.2 

14 

SSHgt 

m 

£7.2 

15 

OffNadir 

deg 

f4.2 

16 

SSHres 

m 

f8.2 

17 

IonoCorr 

m 

f7.2 • 

18 

EMBiasCorrK 

m 

£7.2 

19 

EMBiasCorrC 

m 

f7.2 

20 


db 

f5.2 

21 


db 

f52 

22 


m 

£72 

23 

JSSSSS8SSKM 

m 

£72 

24 


db 

f4.2 

25 

IonoCorrRMS 

mm 

f6.2 

26 

SSHresRMS 

mm 

f6.2 

27 

NumGeoBad 

# 

i3 

28 

NumAltBadl 

# 

i3 

29 

NumAltBad21 

# 

i3 

30 

NumAltBad22 

# 

i3 

31 

NumSSHBad09 

# 

i3 

32 

NumSSHBadl2 

# 

i3 

33 


# 

i3 

34 

NumFramesDel 

# 

i3 

35 

NumFineHtKFlg 

# 

(42 

36 

NumFineHtCFlg 

# 

(42 


Converted to 2000 Epoch 

UTC Time 

Cycle = 9.92 days 

Pass = 3372.885 seconds 

Nbr frames used in 60 sec av 



Height of sea surface above 
ellipsoid 



= SSHgt - OceanTide - SolidTide - 
PoleTide - BaroCorr - MeanSSH 



Count nbr All bits Geo_Bad 
Count nbr All bits Alt_Badl 
Count nbr ibits(Alt_Bad2 / l/l) 
Count nbr ibits(Alt_Bad2,2,l) 
Count nbr ibits(SSH_Bad,0,9) 
Count nbr ibits(SSH_Bad,ll/2) 
Count nbr ibits(Alt_Bad 1,3,1) 
Count nbr Frames Deleted 
Avg from ibits(Iono_Bad,13,l) 
Avg from ibits(Iono_Bad,14,l) 


Effective 8/26/96 
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IGDREUConv.f code 

C -Software Request *96/146 

Sea_sur f _Hght residual 

130mm added for unbiased residuals 
SSK res=m 


SSHres = SSHgc - OceanTide - EarthTiae - 

PoleTide - BaroCorr - (MeanSS - 0.130} 


GDRDBAvg.f code 


Check for Useable Data 

if ( ibits (ALLGeoBad, 0,1) .ne. 0) then 
NumFramesDel = NumFramesDel + 1 
return 
endif 

if ( ibits (ALLAltBadl ,3,1) .ne. 0) then 
NumFramesDel = NumFramesDel + 1 
NumTFlags = NumTFlags + 1 
return 
endi f 

if (ALLAltBadl .ne. 0) NumAltBadl = NuznAltBadl + 1 
if (ibits (ALLAltBad2, 1,1) -ne. 0) NumAltBad21 = NumAltBad21 + 1 
if (ibits (ALLAltBad2, 2 , 1) .ne. 0) NumAltBad22 = NumAltBad22 + 1 
if (ALLGeoBad .ne. 0) NumGeoBad * NumGeoBad + 1 

do 40 i = 0,9 

if (ibits (ALLSSHBad, i, 1) .ne. 0) NumSSHBad09 = NumSSHBad09 + 1 
40 continue 

C 

do 45 i * 11,12 

if (ibits (ALLSSHBad, i, 1) .ne. 0) NumSSKBadl2 = NumSSHBadl2 + 1 
45 continue 

C 

if ( ibits (ALLSSHBad, 14 , 2) .gt. 1} then 
NumFramesDel = NumFramesDel + 1 
return 
endif 
C 

if {(ALLAltBadl .ne. 0) .or. (ALLAltBad2 .ne. 0)) then 
NumFramesDel = NumFramesDel + 1 
return 
endif 
C 

if (ALLGeoBad .ne. 0) then 

NumFramesDel = NumFramesDel ♦ 1 
return 
endi f 



Abbreviations & Acronyms 


AIF Altimeter Instrument File 

ADP Algorithm Development Plan 

ADT Algorithm Development Team 

AGC Automatic Gain Control 

APL Applied Physics Laboratory 

CAL Calibration Mode or Calibration Mode data 

CSC Computer Sciences Corporation 

CNES Centre National d'Etudes Spatiales 

COTS Commercial Off-The-Shelf 

EM Electromagnetic 

ENG Engineering Data 

EU Engineering Unit 

FTP File Transfer Protocol 

GDR Geophysical Data Record 

GSFC Goddard Space Flight Center 

HDR Header data 

IGDR Intermediate Geophysical Data Record 

IDL Interactive Data Language 

JPL Jet Propulsion Laboratory 

NASANational Aeronautics and Space Administration 

NSI NASA Science Internet 

RASE Radar Altimeter System Evaluator 

SCI Science Data 

SDR Sensor Data Record 

SDS Science Data System 

SIS Software Interface Specification 

SDT Science Definition Team 

SEU Single Event Upset 

STR Selected Telemetry Record 
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Abbreviations & Acronyms 


SWDT Software Development Team 
SWH Significant Wave Height 

TGS TOPEX Ground System (TGSA, TGSB, & TGSC VAX Cluster) 

TMR TOPEX Microwave Radiometer 

TOPEXOcean Topography Experiment 

UTC Universal Time Coordinated 

WFF Wallops Flight Facility 
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